GTA SA Modding book 


This documentation covers important points on how the GTA SA game engine 
works and the job performed by various internal files. Arguably the greatest 
feature of the GTA SA Engine is its ability to render different weathers and permit 
advanced scripting with a lot of possibilities. Scripters can make complex 
missions: 1640 opcodes are available to use in scripts. IFP files allow the creation 
of animations which can be applied to pedestrians with SCM opcodes either in 
cutscenes or map objects. The player's wanted level can reach a maximum of six 
stars, similar to the previous installments GTA III and GTA: Vice City. In contrast 
to Vice City though where the player character drowns immediately in water, 
swimming is possible in GTA SA. The engine can render various effects. Vehicles 
are destructible and cars tunable. Garages and interiors can be added in IPL 
files. The player's money can range from (-10*9+1) to (10*9-1). The game 
features various weapons and upto 10 can be carried at one time. Some weapons 
are mutually exclusive; for example the shovel and the baseball bat. Advanced 
path files control routes, including traffic lights for vehicles and pedestrians. The 
game map is subdivided into various zones whose upper and lower extents are 
specified by coordinates in IPL files. Models used for police peds and vehicles 
depend on the town zones of which there are 3 (LS, LV and SF in standard game). 
GTA SA uses a compact save file format that stores the most important data like 
weather, global variables, player info and so forth. The radar contains a lot of 
information and helps the player find points of interest on the map which are 
generated through SCM scripts. 
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To add before the release: 


- 0003 shake_camera.avi to 0003 opcode 
- GTASA probably CLEO requires Microsoft C++ Run-time 
- Replaced objects into tables up 0 0019 opcode 


Page 3 of 186 


Table of contents 


TDI OF COMO saciocs coesividiccccuitoraanelncaciesnnavad Caines bunined Saensacvaweradsiaasteuansuxndivesewasaa eieeeeess 4 
RSI lene tape ctcessedaacececesedautstesan eens tieseterosce tue tee mee nant tenes ta hesetbeseneraeedematesssedaneete ee 10 
LINES ON YS sats soe cade Shivdectexececy mdieeouxeeesdae vadean cade ekeuecas stan sdnean ea ubuaeeedaaneatubuanesanetueas 10 
Phifer y WOAUSO TN SS osecctpct siege ceeeaacea ep nosasencten cequviau aves daenrere eaten meet basiees! 17 
A Game SEQUENCE Of WOI KING is iivcssssccsesscnsswestessendeanceteasbsanven saan ante dnocnesmesereensiansns 22 
PCM TA es sane coat cce atesaneccsete rae neraredandacnto ends wap tove nedaiaetensetorneonanseueedantenien metaced: 22 
Virtual KY COC 6S ig ccdesctscepieccdss cts cadexc dept secsande sei acageree ae eed sie eeccneaee 29 
STASA: CRES2 Mashirid) Sl Or tli acc cick eceseeeicp nance ecentinvenens mb seat swietinennetind es 36 
Spd ee gla = a eee errr tree rere etre te Srmrr eer eer rer er er nete eee Pmerren, er arte eee cre: ere ree 38 
E> BASIC PMINCIPIOS secs: acncs eters iwrenie Siac eee een eens ane acd e 38 
Oo ene ee ree eee eer een eet er ee ae eye reer er ter ere er rrr eer eae 38 
DOTS CA) CC ares Shchiacee tok sepals enter anee mieten ei deeokenaud ea de pianbac mina Oaa sedan eee 38 
Basic map file - external files to lO€d............ ce ceeeee eee ee cece ener eee eee ea nese eee eee eseeeeeeae 38 
DA tess aes eee nls esse cee aes na ees eee ctor ews eee 39 
ME cee terse ede e eco aecace sh pene nates seat eae sce ens eae aa acetate 39 
aN tga cate age te pees es beasts ations ohisanse Sonesta Seneca eae oceania 39 
TPL ai MIB PAO Bcc cvccecccaeesnsanidanscarasnicecnsaeauidesecctatdavexere cancers cananeis conenioueeannes 39 
Bee IB 6 0 || | errerereer me rere eee er eer cere tee ne ere ere ree ree eer rere 39 
ih @) Bl S| El Caer eer ere Serra eer eee eer er Carer rer err eter crete ere tr arene 40 
PUMA ULE toc icc giao aaddanea Sea aedtcaa nate lecpie sen caes ivaniamn pen besaseaabdeepouslmecuamesenheanareadeotins 40 
EX lMistecsncerwensavndevneesnsandevnceinetvdds wecunenvads Saatwsrudag besiaaeiageantnantuearadeiseasetesdeadeandiiees 40 
Declaring objects (IDE and dynamic object fileS)........... cece eeee eee eee eee eee eenaes Al 
IDE TSS: SIGS STING eee enterasrncisecteicinsecaenicectiene ces al eaeadeen dt cnacteasaceeats 41 
COPE Sis cist scared cataiananntaaass atl avawsasanvewncsvuataveassawssxeuheusawedxendecau une vsadrenuseuenaruetonal 41 
PAG) catectasvonestestaaevsensaers ausnedausesstiet caanaenateatveetcaseecienedsauracensreasieaaesesauaceas teers 43 
General appara Gras eceissdeccavysrscedenavyetaanss vansnesadedtedeanaxsabiadeanengeuasdessenctventaanied 44 
BE MSS atria sees ee scence ace other etm eee eee ee ae eee one 44 
MEP OCUCUIOM iisiesscae cvossaresaanesvaa bacunuxeuaxmaaxaniiceketenseaaniexwse saiale medeces mu emmenewneed 44 
POA ciroctsanccencedanceteesredagaehonsstelaauhonssheanten Deatonenssateicersdsaseanraetanacsiunees 45 
Ps atiecscciearete tina ea ecenictia hi teuaen ane ada ease te ciaeiden aleve ae en ennecetadeiatens 46 

Br ade siecteresioa epicenter an ne ena Temas at onen Gauloasaien SheidhanssGuanedniensaus tne samaueensens 47 
See more informations for ENGINE (tO CO)..........:ccceceeeeeeee nessa tesa eee aeeeaeeaa eee 48 
MOTIONIBEUIR (OHOG) iasciiscaieteccrraeuiesceyexes-bosasaieieibean eee eae maneenas 48 


Page 4 of 186 


INPUT ace vatevesi a hanvavavanaeevia tbr gerd ctae add dal sanav nn oedaws deta sb stedaad savings daaatiaee 48 
ASCII tables oes do seree shea eaae sc iGarees ead senuge earner eneesn a gus dsdaden Veesaea den Gene cs rong 49 
REFLECTION wenecscseteausucteusventaretemhs anetessaues aietaaetd seastsaaneteesbdemntesiattanesacteatare 56 
EOI arses ctns daxiececie vio Soe redorenes Soavaeex Ges dee sanecieas ened conan waed ad asad eaten oats 62 
SAO CEO OG) ite cree sued tiers Saicecaia ta hens Seeile ek ears hist ehedaeane seek salt aaacin nai a nea iat 63 
COLORCORRECTION (to dO) .i.csscaninunenianiianddandiaiiauiin catia ies 63 
WAGER vacsat dacsidacsads shah dacandscaabytde Chasaateas sas heans anes gersine goed bya sanbi dean geateaebeattecagtiad a 63 
SHADOW wisteeiisses cctv esget cong saierews cent sdinedd eeiineade det cniee Viet eceeanive eee eee 65 
ENGINE: (lO GO) iii conccwessid va liinena tecaeenr stated tana felis Se idnaiel Sesiak suic Ten aed aaseear 67 
MOTIONBLUR: (tO dO)... ici iaetensxseasceecnssecaectexaiva Aaedirediwiedaisaidevivaackaw iieas 67 
PERPIXELLIGH FING (06 CO) secesessccesecns ees tavasaasacicedacaried sate siadtideaetstvaacettaisabaates 67 
DEPTHOPFIEL De cccwedevosdsveved eons daxvecerans dexvenex des duxvenexeiavoed eave aval abliabieetencurwiads 67 
VOINICIOS 6 ia ceca se cutasealid sue gesls Seether Scene shai A tices aut el nae du hde setts alle Atlas eelad seal anesieeee, 70 
PGR OM sot 2 tN ES oye al Dh ten eats ROA ASIC ON aN J 70 
US cists Sea tase a Esa alc 2 aca ala ur Ste tu I rata 70 
COnhGuiing VEMICIC sccoless evasion ge eet esa eee ae Beas 72 
Declaring vehicle: in IDEs sccis. a2 ve pedo Sasoa ds fee eats i ehuaten sagas mula eep dive deees iis 72 
Vehicle handling - handling.cfd..............ccccceeeeeeee cee e cece eee ee ee essa esae ees eseeseeaesaes 72 
PRUE T OMAR facades vote tte laters be ts Dette aul dnas i lan alin Doha bial Pu tes 72 
Explanation of sections and paramMeterS..........ccccececeeeeeeeeeeeeeeee test eeea eee n tented 72 
SLI ean Cl eas acta acetate aia eats haat oh ka ah, ulate tls hati ca Seale ok Se a 72 
Sound properties - VehicleAudioSettingS.cfQ..........:cceceeeeceeeeeeeeeeeeeeeeeeaeeneeenes 75 
LEV AINE EG acs ca cate ae sh eae ante ne deere 76 
PRAGHOINIM, seve soul atts vce Sere ae aed eae A eed teat ese as 77 
FEELING Ad wi steve eda Sa ea ecah Gece adi dan Uo aae ke cela baa a che adbneue nad seo nec edenasacuese eae uavesbs 77 
Bilary Tile: SHSCIM CATIONS 4.1.:4522 2002 acs yaccssaeaaad viabstanoadeee bessauee sen Danenes wwettageaetanantenstaaeers 77 
IMG AP CHIVe( IMIG) xed ses save cateceteeds iate cede cess cveede eek Bei vheweey Magedex cea den etaen cond dp cnsausedens 77 
PCL SMG: ECU OM ssicciien dco ascasnncioe eaacensaniaetaGeneauiier dal weeteaeraawiemeacosnecdavcen dete manda: 79 
Crazy IMG *EOitOl 264 fenced aed veld eter ate at eenc Sees Matec ek ce eee nus ie eeece teak 80 
GEM G vezi ccgnsde vazcttgheduireantranibaaeaelacaitarisbaeansbens. baababea neh aananesh nianeanibenckinededneuene< 81 
IMG (Mana GOls sestisrccaeieetctadt a axtiescyareyssieieds cay ssieeaas caer each eae nee es 82 
DMG TOO lhe att atari tea into uen areca a taten ed) patter ds tan tebeun suaaleh dees duane leautecce 83 
SUG LIC ECU EON ae cs 5a cee'd a nate gees Seca She wee sake She ce wa ewes nv cae eet er ee ene 84 
SCM: COMPING SGP: saccstcvicedescktecseecusaeterseteser suacctecdsesrcaoetenevgaraetaaedeverbeancendasess 85 


Page 5 of 186 


E XACE COM SOD GOS tid aa I ia eee a tule 85 


EXaCE COdG:= Cala ly Pass. 2ce i fi meathiiiea dered ata eis wile eee eal favect dl Mea See 85 
Exact code - array, data next after primary variable...............:cceeeeeeeeeeeeeee es 86 
Exact code - array, type of multiplier and multiplier for index from secondary 
Wea ss0d opine i ue sen Dans nde tal ere abt toad as seat Ueot unas his thon ad sa haae Nuaay eeee tha seated 86 
EXaCEICOdG:= di Fay Cx ale sfc cdee cw yet diesen Gaus ie etek ade de aes ee ek 86 
PRU accion fa ocala ih aR gE a ata ata Saleen AN a tad Set aur As ee Ue ls 87 
PICO a Pio ieet ASU Neer tA St Nyt Cat eet Ae Nita de Ae ys Ad is, Ae te hy, av Peat AA ite atthe 87 
LISE:OF FAOIO SLAUIONS irene ete hake St we Siete secede eter tate Ae Saeki a dens Ns demas! 87 
MC TINO Ricoh Ae be tate eee tt eas iol atata fests lari atlas Garauh ataevue a tgateties setae eauverecs onthe 88 
BERET EU MeN seca ate cea a AR a ae an A ae 2 88 
How the process in MeEMOry WOFKS...........::cceceee cece cece ee ee eee eee eens eee esas eee eeeees 88 
FIGX GCM NS asic oi deere vedas sesicdlng els aps aap tae Skene tataa ashe aden awecieae ce ouececeesaece ror easanven se 89 
NOP ODS ralloniid::: inchs. teinstevchengcactesaetgnsseesenntar stares age secdayalast sec antontenan’ aeccantoedere 89 
Vale EY DAS acc docs ca ncesienaed cosa ceves eptseh cena seek sed iw eed Hew taexesk Reith ae 89 
Finding & patching Memory ACAreSSES.......... cece e eect eee teeta ee ea teeta een eeee 90 
Assembler SHOPrt pS.iceec ces sae asc veces vara pects ae ds vee eaaaa aseadyva rent radeehee ees 93 
PUPICEION: ag OreSSOS. icexs cnc voidecse inched edacaneg ees suaceadana ina tandeuncbeaieutsceeieessneuikedaladeesends 94 
MEMORY ValU@S ies ccoctscereitet eayed cca cae ath meres aegeebie lee lee Gees 94 
WREALCGON ZO soc ee i acts eae edd thee do le ese dees suede tenance teleseceac 94 
LAT ATES rests an iar ates Seen She ashore dee ae eareencetentoarnuse ath ox ovacke sae guveveany exevueiecane vee est es 94 
PIGV GN ckcoenderetessabdereitecsutuSenatenaatedese¥aceatio’ stasecast sean wae amsnseee uabehescecessetoaseabeetuem 95 
CNN Sits sid eieate tate erin cal cared dale Seed ails Past d oie Pea Aaeaumie rere aoa teal neared aes 95 
WAU ONE resect lsse Rissa sas tier N dh AA es tote oe 2s oho See es ure ee Saat! sce tei act eta 95 
ACEO tek Joe oN a ltt tena Aa ts Si hiad sabe Ahad delete ede saints teal We dc atatd dade ide 96 
A Fe 9 Wc [Rene en err ene ee oman: eo er rr CP ne 96 
PRC TOT, SECs oc duuncsn asa cade tence sera suaeansannesentansndaveuaencates ess eons staearsaumeetaneaees 97 
CVehicle= spawned VeENiCles ii sccs sean deny sii ototenss fistoomavanidiooneleamu anaes et ei 97 
CNC AES Seo a Se oe es haa heh Stas A A los eas So Nase is 97 
SI OD Cd so at rede ata an a vc ai le ei ene alacant 98 
LISHOROPCOGGS-.t Ave aes AS iy i Aas Citak ues Otol ds ite o ti Me atari a) Neh sotto aie 98 
COINS ety cites ceatasehinsevataara el avarasaslet thane du lathel ahulisat hit a dacs saws tateNe eeu out ws teleateaebtdt 98 
Cisse is Hinde tira (adeiden deg ieee atid Mee dhiah dated ie hd Aaclndet br clnetidder Uaatuehitdeieduevdes aaeyds 98 
PE sega casas a at SOI ge a Re aN a ete 98 
IOP cosh chiesc dua clact cancteat udu aasa tenons eveaneugeneens yuan cee wecsirecsueemerssshuen mersbancieeerseatusons 100 
PAY OM 226 vec ecie cae iy cess ces Vente hace Gare niece Sac daa eaies anae dhlitgw tae Shs aden dhe cea v evens Ree 100 


Page 6 of 186 


SM SSERICEUIE OD CO OS wcrc casas ates et al a a ia te ta ates 100 


SEAMGSrG iO PCOGSS sii i tededad 2 eet slic sade taten Tees eas The cele does Ona edad dueateceaeee 100 
DOO NO Pe seca calcu anieaea eecncnh save ivaseas cesteved aden Gu eaedip pean debeawapearcuwueeninanecnseeuees 100 
OOO LD = WAIT s.cstecastecsnterdsetensetenstenadaetgs otanesant tena saeaaerenctedecanebatweeahiatesatateneaeanoes 101 
OOO2 SiGOTO i asged ass iets tew casita denen baad ones arias Meiea da debieieeneeia era aeenesiel 102 
O003>= SET. CAM SHAKE) ences aveniuiecakaploshitsonaatonsiekoumtadcmumenndmvewicmbuanacmeent 103 
0004=-'set_global_int: variables wii cciacwauiani anid aidan aria ae 103 
0005 =-set. global Tloat: Variable. s.c.c:si2c22inesiaachecandacensas neersaserpdekeosd veanauteSendece 104 
0006=set. local. int: varia DIG i sicideiccerilied basceeeeed ca iactenaton cackeeda eave oenes 105 
O007-=Set local: tlodt variaDlerais oierai sei ota eaeh catkins mela auiiain on eeaWedere 105 
0008 - add_int_value_to_ global variable... eee eeeeee ee eeeeeeeeeee ae eeeeneeeee 106 
0009 - add _float_value to global variable........ 0... eect e eee ee eeee renee 106 
Q00A -.add_int value: to local: Variable). isciciiiecenivitieceneveccesteiionenietvesaeeess 107 
OOOB - add _float_value to local_variable....... eects eeeeeeeeeeeeeeeaeeeneeees 108 
OOOC - subtract_int_value_from_global_variable............ cette eee 108 
0OOD - subtract_float_value_from_global_variable..............ccceeeeeeeeeeeeeee eee 109 
OOOE - subtract_int_value_from_local_variable...........ceceeeeeeeeeee setts eeeeeeees 110 
OOOF - subtract_float_value_from_local_Variable........ cc eeeeeeeeeeseeeeee teen nena es 110 
0010 - multiply _by_int_value_in_global_variable............. eee 111 
0011 - multiply _by_float_value_in_global_variable............. ce eeeeeee eee 112 
0012 - multiply_by_int_value_in_local_vVariable........ ee eeeeee eee seen etna eeeeee 112 
0013 - multiply_by_float_value_in_local_variable........ ce eceeseeeeeseeeeeeneeeeeee 113 
0014 - divide _by_int_value_in global _variable.............. cece eeeee eee een ees 114 
0015 - divide by float_value_in_ global variable............ cece eeeeeee sees eeeeee 114 
0016 - divide_by_int_value_in_local Variable... eeeeeeeeee settee eeeeneeeeee 115 
0017 - divide_by_float_value_in_local_Variable.........eceeeeeeeeeeeeeeeeee seen eeeaee 116 
0018 - is int_global_ variable greater than_value.............cccceeeeeeeeeee eee eee eee 116 
0019 - is int_local_variable greater_than_value............ eee eeee etter eee 117 
001A - is int_value_greater than global variable............. cece eeeee teens 118 
001B - is int_value_greater_than_local_vVariable.......... eects eeeeeeeeeeaeeeeeee 119 
001C - is _int_global_variable_ greater than_global_variable..........00... 120 
001D - is _int_local_variable greater than_local_variable........... ee 121 
OO1E - is _int_global_variable_ greater than_local_variable............. ee 122 
OO1F - is int_local_variable greater than global _variable..........0..c ee 123 
0020 - is float_global_ variable greater_than_value.............cccceeeeeeeeeeeee eee 124 


Page 7 of 186 


0021 - is float_local_variable_greater_than_ValUe........ccecceeeeeeeeeeeeneeeeeeeee 125 


0022 - is float_value_greater than_global_variable..............ceeeeeeeeeeee ee 126 
0023 - is float_value_greater_than_local_vVariable........ cc eeeeeeeeeeee teen renee 127 
0024 - is float_global_ variable greater than _global_variable...............0... 128 
0025 - is float_local_ variable greater than_local_ variable.............ce 129 
0026 - is float_global_variable_greater_than_local_variable............ ee 130 
0027 - is float_local_ variable greater _than_global_variable...............0. 131 
0028 - is_int_global_variable_greater_or equal _toO_ ValUC....... eee eeeeee eee ee 132 
0029 - is _int_local_variable_greater_or equal _to value........... cere 133 
002A - is _int_value_greater_or_equal_to_global_variable...........c eee 134 
002B - is int_value_greater_or_equal_to_local_variable..........eeeeeeeeee eee 135 
002C - is_int_global_variable_greater_or_equal_to_global_variable............. 136 
002D - is_int_local_variable_greater_or_equal_to local_variable................ 137 
002E - is _int_global_variable_greater_or_equal_to_local_variable............... 138 
002F - is int_local_variable_greater_or equal _to global variable................ 139 
0030 - is float_global_ variable _greater_or equal_to valueé........... ee 140 
0031 - is float_local variable greater or equal to valueé.......... cee 141 
0032 - is float_value_greater_ or equal_to global variable.............. ee 142 
0033 - is float_value_greater_or equal _to_local_variable...........0 ee 143 
0034 - is float_global_variable_greater_or equal _to global _variable.......... 144 
0034 - is float_global_ variable _greater_or equal_to global _variable.......... 145 
0035 - is _float_local_variable_greater_or_equal_to_local_variable............... 146 
0036 - is float_global_variable_greater_or equal_to_local_variable............ 147 
0037 - is float_local_variable_greater_or_equal_to_ global variable............ 148 
0038 - is _int_global_ variable equal to_ValUe......... cece eee eee e teeter need 149 
0039 - is _int_local_variable equal to ValUe........ ee eece ects ee tees tees eeean ees 150 
003A - is_int_global_ variable equal _to global _variable........... ee 151 
003B - is _int_local_ variable equal_to_local_variable............ eee 152 
003C - is_int_global_variable equal to local _variable............ eee 153 
0042 - is float_global variable equal to Value... cece e eee eee need 154 
0043 - is float_local variable equal_to_ValUC......... cette eee eee eee e ane 155 
0044 - is float_global_variable equal _to global _variable............ ee 156 
0045 - is float_local_variable_equal_to_local_variable........ ec eeeeeeeeeeeeeee ee 157 
0046 - is float_global_variable_equal_to_local_variable.......... cc eeeeeeeeeeeee ee 158 
QO4D = JUMP: If TaISG:s.cacarsaecocaidescutevnciiiansitanaesansnetavantusaamiarantdssaameurssanutaceaanens 159 


Page 8 of 186 


GO4E-= TERMINATE: THIS. SCRIPT wsecseesseitaccn satin stax vite cciedy weveilexcaa veda wea vedvbeed lakes 160 


OO4F - START NEW SCRIPT. WITHOARGS. cccausevevecd tecctsbvishee erent adenwsnev es ides sacs 161 
OBO" GOSUD oii fees areas edi Geran al das esa a slvaceseraauie sane acte Paaeaseewursaaaurse uaanelds 163 
OOS LT +PGRUMMsasaccattsentcresasncsturscavasaeeseatauas atsaacke tealvaadaad te anetages aeetademnetatneanens 163 
W052 =INOP: TOO xdvesapilactes ccpiesougercapes cen iieaanl ea bacabiee dient sae qaeneaeetaacopenienenie’ 165 
O05S: = CREATE: PDAVER iecuwetsshowanstuttabsaevd katannodil Maan ta de tdan dewaieelsigehnan tata daed 166 
0058 - add _int_global variable to global variable..............eeeeeeee eee 167 
0059 - add _float_global_ variable to global variable............ eee 168 
005A - add_int_local_variable to local variable... eect eee eee eeeaeeeaee 169 
GCLEOS CP COdes e547 cot iicn. sd cote ee eae ad Deets pte tliat Wane iew aerated 170 
OAC = WIibe: MICMIOLY: sasiesveucsevecaa'sancuslinsns cuvsiiealezas duestaa adenbuecidianecuaveasessasieancielts 170 
OABO = Virtual KEY PreSSOC st: cccigacsetaccsidessuetdnateosebdasatdeerabdtanktenachteaatontiomate 170 
ASCII Pale ses icsisaegesdie vide xeeveca vedexiess Snad uxgeks toed ex biaaleoded ca iaaisiawed exeiats towel enes bested dendets 171 
WPGMIMUN OLOGY cccsshccnc ss see feeces eek ress ha hih otillas uit cou seelad se lia Neeied aceauld ones are rth dne eat 179 
PRETCTANCO Ss Git toi ss PO haa oA AON She ON 2 fe cuss Ae es ee 179 


Page 9 of 186 


General 


There are patches for GTA San Andreas. In this documentation it is tried to 
explain things for: 


1. GTA San Andreas v1.0 [US] HOODLUM No-CD Fixed EXE: 
EXE size: 14 383 616 bytes 
EXE MD5: 170b3a9108687b26da2d8901c6948al18 
EXE SHA-1: 185b73fbceaa05d66452691fc0d15c8d61b92a7e 


2. GTA: San Andreas v1.01 [EURO] No-CD/Fixed EXE: 
EXE size: 15 806 464 bytes 
EXE MD5: 25405921d1c47747fdO01fdObfeO0a05ae 
EXE SHA-1: de9ebfe4943d1d1888b8adabfef2e7d4fa4f0943 


Limitations 

GTA San Andreas imposes specific limits on certain types of object instances and 
files. Exceeding some of these limits can make the game crash. Or the game may 
skip the extra data and load only as much as there is place in memory for. While 
several limits can be overcome using SA limit adjuster, many are still yet to be 
hacked. 


This table lists short names for the limits, long descriptions, their default values 
and whether or not they can be hacked with existing plugins. 


ae Default value How to 
Short name Description ~~ of limit avercana 
Map limits 
The Number of Use SA Limit 
IPL Instances i 
Adjuster or 
allowed in the Mlaxandar 
IPL Instances en le 13000 Blade SA Limit 
objects increases pa lguass 
gta_sa.exe 1.0 
of IPL instances Fenuined 
e.g. buildings. q 
Use SA Limit 
Adjuster or 
NOTE: Increase Alexander 
Dummies to increase IPL 2500 Blade SA Limit 
Limit Adjaster 
gta_sa.exe 1.0 
required 
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Use SA Limit 
Adjuster or 


Alexander 
cing : 70000 Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
Use SA Limit 
Adjuster or 
NOTE: Increase Alexander 
ee to increase IPL 3200 Blade SA Limit 
Limit Adjaster 
gta_sa.exe 1.0 
required 
Use SA Limit 
The number of Adjuster or 
Alexander 
In IMG, IPL allowed binary 256 Blade SA Limit 
Files IPL files in IMG Adjaster 
aichine>: gta_sa.exe 1.0 
required 
The number of Use SA Limit 
stunt jumps Adjuster, 
SfUne MMPs allowed in the Ze gta_sa.exe 1.0 
game. required 
Use SA Limit 
The number of all Adjuster or 
Cae collisions. COL Alexander 
es file can contain 10150 Blade SA Limit 
more than one Adjaster 
collision model. gta_sa.exe 1.0 
required 
The number 
which describes 
how many COL 
files can exist in 
Collision files all of IMG 254 - 
archives. There 
are 251 .col files 
in unmodified 
IMG archives. 
Use SA Limit 
Adjuster or 
Alexander 
aaa a : 400 Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
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Use SA Limit 
Adjuster or 


Alexander 
eee : 40 Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
Use SA Limit 
Adjuster or 
Alexander 
MatDataPool - 4096 Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
Use SA Limit 
Adjuster or 
Alexander 
AtmDataPool - 1024 Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
Limits Use SA Limit 
determines how Adjuster or 
Spawned many vehicles Alexander 
vehicles in can be spawned 110 Blade SA Limit 
pool and exist in pool Adjaster 
at the same time, gta_sa.exe 1.0 
“now”. required 
Use SA Limit 
How many Adjuster or 
Alexander 
vehicles can be Blade More 
declared? Each of Vehicles 
Vehicle IDs d venicles ie 212 plugin. Vehicle 
eclared on its Audi 
: udio Loader 
own ID in IDE file, for sounds ot 
by default it is 
vehicles.ide Hew venicles 
gta_sa.exe 1.0 
required 
Limits Use SA Limit 
determines how Adjuster or 
many peds can Alexander 
Pepa upaaee be spawned and 140 Blade SA Limit 
exist in pool at Adjaster 
the same time, gta_sa.exe 1.0 
“now”. required 
How many ped 
can be declared? ea. SA Limit 
Each of peds is Adicter 
Ped IDs declared on its 278 J s 
own ID in IDE file Gia Sexe 10 
; required 


by default it is 
peds.ide 
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Polygons 


The maximum 
number of 
Polygons that a 
model can have 


5000 


Use SA Limit 
Adjuster or 
Alexander 

Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 


EntryInfoNod 
es 


Number of 
pickupable items 
you can create 
via SCM Scripts 


500 


Use SA Limit 
Adjuster or 
Alexander 

Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 


Objects 


The Number of 
Dynamic Objects 
creatable 


350 


Use SA Limit 
Adjuster or 
Alexander 

Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 


Tasks 


500 


Use SA Limit 
Adjuster or 
Alexander 

Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 


Events 


Point Routes 


200 


64 


Use SA Limit 
Adjuster or 
Alexander 

Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 

Use SA Limit 
Adjuster or 
Alexander 

Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 


Patrol 
Routes 


32 


Use SA Limit 
Adjuster or 
Alexander 

Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
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Use SA Limit 
Adjuster or 


Alexander 
Node Routes - 64 Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
Use SA Limit 
Adjuster or 
Alexander 
fiigo sects : 64 Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
Use SA Limit 
Adjuster or 
Ped Alexander 
Attractor - 64 Blade SA Limit 
Adjaster 
gta_sa.exe 1.0 
required 
Cargrp.dat 34 groups, 23 
assigns vehicles vehicles per 
to groups which zone. 
cargrp.dat are assigned to Last 4 groups : 
zones by SCM are reserved 
script. for cheats. 
Pedgrp.dat 
assigns vehicles 
to groups which 57 groups, 21 
pedgrp.dat are assigned to peds per zone. : 
zones by SCM 
script. 
Maximum Use SA Limit 
, number of Enex's Adjuster, 
Entry Exits Rie tobe 400 entry exits gta_sa.exe 1.0 
defined in IPL's required 
Amount of 
Suaies ence oe oA. Eira 
around camera. Adjuster or 
When too many po nace 
high-res textures Blade sream 
are added to the Memon Es 
Streaming game they 25600000 B = his 2.0 version 
Memory disappear 25000 KB = increases 


because there 
isn’t enough 
memory. 
Increasing this 
limit solves 
texture loading 
problem. 


24.4140625 MB 


streaming for 
vehicles and 
crashes game. 
1.0 is good; 
gta_sa.exe 1.0 
required 
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The number of Use SA Limit 
Timed tobj's that can be Adjuster, 
Objects defined in IDE Ze} -OvIERtS gta_sa.exe 1.0 
files required 
Te Maxie Use SA Limit 
number of water 
: 1021 water Adjuster, 
Water Planes | planes defined in 
planes gta_sa.exe 1.0 
water.dat, they required 
are 
The exam Use SA Limit 
number of Adjuster 
IDE objects declared objects | 14000 objects te cece 1 0 
in .ide files by g =a tired 
objs keyword. q 
Carmods.dat 
contains list of 
cars and the 
mods that can be Use SA Limit 
added to these Adjuster, 
Carmods.dat Rare h Mieaie 70 tunable cars seca 1.0 
describes how required 
many cars can 
occur with parts 
in carmods.dat 
The max number Use SA Limit 
of colours in Adjuster 
Carcols.dat colour table 128 colours : 
etinedain gta_sa.exe 1.0 
carcols.dat Regula? 
The max number Use SA Limit 
SCM Mission of bytes one 69000 bytes = Adjuster, 
size mission can have 67.4 KB gta_sa.exe 1.0 
in main.scm required 
Number of 
Mission local available local 1024 (0@ - ; 
variables variables in 1023@) 
missions 
34; 
0@ - 31@ 
Number of normal local 
Thread local available local variables : 
variables variables in 32@ - 33@ INT 
threads millisecond 
timers growing 
up with time 
Number of a 
created threads sai are te 
SCM Threads | by 004F or 00D7 96 threads ea 
opcode in sere aad 
main.scm reas 
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The max number 
of vehicle 
handles which 
can be added to 
cleanup list 


Mission ier 75 vehicle 
: during mission. - 
Cleanup List Thace vehicles handles 
will disappear 
after an 00D8 
opcode is 
executed. 
8 IMG files: 
The max number el eatin 
IMG Files of ie IMG basic map file 
3 of them are 
hard-coded 
Use SA Limit 
IMG Header Adjuster, 
ING HeAGers Allocation ute gta_sa.exe 1.0 
required 
Probably the 
maximal Bue 
De Sree coordinates 12000.0 ie SA Sere 
defining the Adjuster, 
: where could be coordinate 
maPPi an object placed points Giese exe” 
bounds snd work required 
correctly. 
Game loads high- 
res textures and 
models around 300.0 Use SA Limit 
; up to specific fe Adjuster, 
POD Distance distance. After oe gta_sa.exe 1.0 
that distance P required 
textures aren't 
fully loaded. 
Use SA Limit 
Number of active Adjuster, 
Markers markers created 175 markers buggy 
by SCM script. gta_sa.exe 1.0 
required 
The max number use oh Eve 
Garages ol galades added 50 garages ie 
i rae Ue ae gta_sa.exe 1.0 
gr9 required 
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Pickups 


The max number 
of active pickups 
created by SCM 
script. Weapons 
on ground, save 
icons - they are 
examples of 
pickups 


620 pickups 


Use SA Limit 
Adjuster, 
buggy 
gta_sa.exe 1.0 
required 


Players 


The max number 
of players, all of 
them move on 

key presses 
together, but 
camera is on 
recently created 
player. 


8 players 


Use SA Limit 
Adjuster, 
buggy 
gta_sa.exe 1.0 
required 


Weapon IDs 


Number of 
weapons which 
are defined in 
gta_sa.exe and 
use handling in 

weapon.dat 


47 weapons 


Towns 


Number of towns 
which have 
individual 
weathers, police 
cars and peds. 


3 towns 


Map 
coordinates 


Max coordinates 

of area displayed 

on map in menu 
or radar. 


From -3000.0 


to 3000.0 units. 


6000 units 


Radio 
stations 


Number of 
existing radios 


12 radio 
stations 
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Primary loaded files 


At the beginning GTA San Andreas exe loads primary files which point to another 
files. These files cannot be removed because the game expects their existence. 


They can be divided into following parts: 


Menu, before loading or starting new game 


Movies before loading 


movies\Logo.mpg 


Video containing Rockstar Games 
logo. 


models\GTAtitles.mpg 


Video presenting GTA San Andreas 


models\txd\LOADSCS.txd 


Splash screens, EAX, Nvidia logos. 
Textures displayed on loading the 
game. 


Menu textures 


models\fronten_pc.txd 


Mouse cursor in menu & crosshair 
texture 


models\fronten1.txd 
models\fronten2.txd 


Radio station logos 


Textures drawn on corners in menu 


models\fronten3.txd 


Seems like unused textures being 
on purpose to be drawn on top and 
right corner of menu. 


models\pcbtns.txd 


Right, left, up, down arrows 


Collision file 


models\coll\peds.col 


Ped collisions, it is not standard 
collision file 


Audio files 


audio\CONFIG\BankLkup.dat 
audio\CONFIG\BankSlot.dat 
audio\CONFIG\EventVol.dat 
audio\CONFIG\PakFiles.dat 
audio\CONFIG\StrmPaks.dat 
audio\CONFIG\TrakLkup.dat 


Configuration of audio files, 
following contain names, positions 
and sizes of tracks, sounds in 
particular. It is very simplified 
information. 

PakFiles.dat contains names of 
audio archives from SFX directory. 
StrmPaks.dat stores names of audio 
archives from STREAMS directory. 
None of archives can be removed; 
only name can be changed because 
GTA SA refers to them by IDs. 


audio\SFX\* 


Depending on PakFiles.dat an 
archives from this directory are 
loaded. Files contain sounds, 


voices, engine effects and so forth. 


audio\streams\* 


Radio stations, police, adverts and 
ambience. Archive names depend 
on StrmPaks.dat 


Decision files 
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data\Decision\PedEvent.txt 


Decision ped events. Loaded after 
loading screen is displayed and 
before a menu arises. 


data\Decision\Allowed\* 


Decision files are used only by 
decision opcodes. Removing them 
doesn’t make crash the game. 
Decision opcodes use them so that 
they should be kept. 


Fonts 


data\fonts.dat 


Contains ASCII character table and 
positions to display chars 


models\fonts.txd 


Characters as transparent alpha 
textures. 


Language files 


text\american.gxt 
text\french.gxt 
text\german.gxt 
text\italian.gxt 
text\spanish.gxt 


Depending on current language and 
their names in exe or memory one 
of .gxt files is loaded. GXT file 
consists of short GXT names 
(hashed) and texts. Not exactly GXT 
names, just hashes for which game 
must know GXT name to find GXT 
entry with proper hash. 


On loading the game 


File 


Description 


Game scripting, missions 


data\script\main.scm 


Main.scm is mission scripting file 
loaded when standard game is 
selected. It consists of declared 
objects, scripts and lot of opcodes. 
Things to do in missions are 
programmed and compiled to this file. 
It is binary file. Compiled main.scm 
with included external scripts 
requires .scm files placed in any of 
loaded IMG archives. Usually data\ 
script\script.img is defined in gta.dat 
for this purpose. 


Routes, paths 


data\Paths\ROADBLOX.DAT 


Contains information about where to 
put road blocks during police the 
pursuit. 


data\Paths\tracks.dat 

data\Paths\tracks2.dat 
data\Paths\tracks3.dat 
data\Paths\tracks4.dat 


Following files contain train routes. 
These are text files and comprise of 
coordinates and angles. 


Most primary files referring to another game files. 
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data\default.dat 
data\gta.dat 


Both files have the same format. They 
are most primary files which refer to 
load external IMG, COL, IDE, IPL, ZON, 
TXD files. Mainly used for loading IPL, 
IDE and IPL files like default.ide, 
peds.ide, vehicles.ide. IDE files should 
be declared before IPL in these two 
files 


Hardcoded IMG 


archives to load 


anim\cuts.img 
models\gta3.img 
models\gta_int.img 
models\player.img 


These are IMG archives those names 
are hardcoded in EXE to load. IMG 
archives contain the game files, 
usually: 

e §=6.dff models 

e .txd texture archives 

e §.col collision sets 

e .ifp animations for peds or 
objects 
.cut cutscene text data 
.dat cutscene camera 
movements 
Note that cuts.img is only opened 
when start cutscene is executed and 
GTA San Andreas is playing cutscene. 


Map related files 


data\furnitur.dat 


Interior furniture groups data. This file 
is actually unused and can be left 
blank, but it must not be deleted, since 
the game tries to parse it. It originally 
contains information about furniture 
which was planned to be used for 
automatically generating different 
furniture in interiors. However, this file, 
and the interior models/collision files 
are not used by the game engine, and 
other required files are missing. 


data\object.dat 


Contains some object properties, for 
example it is used for destroyable 
objects. Object is identified by his 
model name and had to be declared in 
IDE file. 


data\plants.dat 


It contains information of plants. 
Names are hard-coded in EXE file and 


were compiled from ColPoint.h 
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data\procobj.dat Dynamic objects are defined in the 
object.dat file. They must be defined in 
an IDE file first. With additionally 
defining them in the object.dat file they 
will have special abilities. Dynamic 
objects are used to create objects 
which are able to interact with their 
environment. For example they are 
able to explode or open when the 
player approaches them (garage 
doors). 


data\surface.dat Contains multiplies of surfaces for 
WheelBase (Rubber, Hard, Road, 
Loose, Sand, Wet). 


data\surfaud.dat It assigns audio to a collision when 
objects interact with the surfaces. The 
interactions include the footsteps peds 
make and vehicles sliding on the 
surface. 


data\surfinfo.dat Contains information of objects how to 
interact visually. For example sand 
objects when car tires sink in and can 
get bogged down. 

data\water.dat The water.dat file contains information 
about the water planes inside a 
boundary, which normally has the 
same size as the map boundary 


Game apperance 


data\timecyc.dat The timecyc.dat data file contains the 
most important settings about the 
game's appearance. Basically it stores 
important information like colors and 
lighting for different hardcoded 
weather situations for each time of 
day. The settings themselves are 
constant and build a cycle around the 
whole day. So the exact name of the 
setting is time cycle. 


Player related files 
data\ar stats.dat Stores the stats reaction variables 
data\clothes.dat File listing cutscene replacements for 


clothes models and rules about what 
clothes models can be used with what. 
It contains rules to change clothes if 
some other clothes don’t match or 
cutscene is loaded. 


data\shopping.dat File which has every object's price in it. 
The file is broken into sections by type 
of object e.g. car mod, furniture. 
Tunable parts, headdresses need to 
have prices. 
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data\statdisp.dat 


Selects when to show messages based 
on stat values in the game. When stat 
of player is getting lower or higher 
than certain value, the game can show 
message, for example “ 


Ped & Player and vehicle related files 


data\melee.dat 


Contains information on melee attacks, 
including damage and animation 


data\pedstats.dat 


Ped stats which are used for declared 
peds. 


Ped only related files 


data\animgrp.dat 


File describes the anim association 
groups. 

There are walk cycle groups described. 
These walk cycles can be applied to 
peds in IDE files. 


anim\ped.ifp 


Animations which don’t need to be 
loaded by opcodes. 


data\ped.dat 


# Acquaintance options: 
# - Hate 

# - Dislike 

# - Like 

# - Respect 


There is specified group for every ped. 
This file controls how groups react to 
peds from other groups. 


data\pedgrp.dat 


Contains a list of ped groups for each 
group type. Each ped group should 
contain 32 ped type names. Please 
don’t use 'maleO1' in any of the 
pedgroups 


data\weapon.dat 


The file contains information about the 
weapons properties and settings. The 
weapons themselfes are defined inside 
the WEAP section in IDE file, usually 
default.ide located in the same folder. 
IDs of weapons and sounds are 
hardcoded in executable. 


Ped and vehicle related file 


data\popcycle.dat 


Fore each type of zone (Business, 
Countryside etc.) we have a that 
controls the ped densities. 


Vehicle related files 


data\cargrp.dat 


Zones are defined .zon file as 
coordinate corners. Each zone can be 
associated to car group by SCM script. 
Vehicles are assigned to specific 
groups in cargrp.dat. Cars drive on 
paths depending on car groups for 
current coordinates. 
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data\carcols.dat This file contains all the info about the 
car colours. There are two sections, col 
which contains the colour table and car 
which contains the possible indices into 
the colour table for each car. 


data\carmods.dat List of cars and the mods that can be 
added to these cars. Each of tunable 
cars must be listed in this file. 


data\handling.cfg The handling.cfg file is a text data file 
format which sets many performance 
and behaviour values for each vehicle. 
The file can be opened and edited with 
any text editor. 


Common vehicle textures 
models\generic\vehicle.txd 


Grass 


models\grass\*.* Grass models. Any DFF file can be put 
to grass directory and used in IPL files. 


Effects 

models\effects.fxp Text file containing an animations of 
moving textures to simulate fuzzy 
effects. 


models\effectsPC.txd Effect textures e.g. fire, smoke and so 
on. 


models\particle.txd Contains world particle like clouds, 
water, shadow, blood texture. 


This list covers files whose paths are hardcoded in executable. That's why they 
are called primary. Some of them (default.dat & gta.dat) point to another files 
and some need settings in other files. 


Two of most important files are data\gta.dat and data\default.dat which point to 
external map files (IDE and IPL, COL and so on). They control what additional IMG 
archives to load. 


The files the game loads for world like models, textures and collisions are stored 
in binary format in IMG archives. They can be created using 3dsMax and contain 
geometry of objects. 


A game sequence of working 

Game is run from .exe file and then load screens including a video are displayed. 
After the user chooses to load or start a new game, whole configuration and files 
are parsed, processed or opened. 


Finally the game is loaded and user is able to control the player or exit to paused 
menu. 


While game is not paused and player is playing, application is programmed to 
constantly some of procedures between each frame. Moving to a next frame is 
called “passage” here. During the passage we can distinguish following actions: 
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e Process world tasks 

e Process world physics 

e Process keys 

e Process SCM scripts, scripting. Threads are processed in descending order. 

e Render textures up to this frame and remove their information, next 
request of rendering textures by SCM script is necessary for each frame to 
keep the textures being displayed. 


ASCII table 


ASCII control characters (character code 0-31) 
The first 32 characters in the ASCil-table are unprintable control codes and are 
used to control peripherals such as printers. 


Dec Hex Oct Binary Symbol Description 

0 0x00 000 0000000 NUL Null char 
0 

1 0x01 001 0000000 SOH Start of Heading 
1 

2 0x02 002 0000001 STX Start of Text 
0 

3 0x03 003 0000001 ETX End of Text 
1. 

4 0x04 004 0000010 EOT End of 
0 Transmission 

5 0x05 005 0000010 ENQ Enquiry 
1 

6 0x06 006 0000011 ACK Acknowledgmen 
0 t 

7 0x07 007 0000011 BEL Bell 
1 

8 0x08 010 0000100 BS Back Space 
0 

9 0x09 011 0000100 HT Horizontal Tab 
al 

10 Ox0A 012 0000101 LF Line Feed 
0 

1 0x0B 013 0000101 VT Vertical Tab 
1 

12 Ox0C 014 0000110 FF Form Feed 
0 

13 0x0D 015 0000110 CR Carriage Return 
1 

14 Ox0E 016 0000111 SO Shift Out / X-On 
0 

15 OxOF 017 0000111 S| Shift In / X-Off 
1 

16 0x10 020 0001000 DLE Data Line 
0 Escape 

17 0x11 021 0001000 DC1 Device Control 1 
1 (oft. XON) 

18 0x12 022 0001001 DC2 Device Control 2 
0 
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19 0x13 023 0001001 DC3 Device Control 3 
al (oft. XOFF) 

20 0x14 024 0001010 DC4 Device Control 4 
0 

21 0x15 025 0001010 NAK Negative 
i: Acknowledgeme 

nt 

22 0x16 026 0001011 SYN Synchronous 
0 Idle 

23 0x17 027 0001011 ETB End of Transmit 
Al Block 

24 0x18 030 0001100 CAN Cancel 
0 

25 0x19 031 0001100 EM End of Medium 
1 

26 Ox1A 032 0001101 SUB Substitute 
0 

27 0x1B 033 0001101 ESC Escape 
1 

28 Ox1C 034 0001110 FS File Separator 
0 

29 0x1D 035 0001110 GS Group Separator 
dL. 

30 Ox1E 036 0001111 RS Record 
0 Separator 

cal Ox1F 037 0001111 US Unit Separator 
1 


ASCII printable characters (character code 32-127) 

Codes 32-127 are common for all the different variations of the ASCII table, they 
are called printable characters, represent letters, digits, punctuation marks, and 
a few miscellaneous symbols. You will find almost every character on your 
keyboard. Character 127 represents the command DEL. 


Dec Hex Oct Binary Symbol Description 

32 0x20 040 00100000 Space 

33 0x21 041 00100001 ! Exclamation 
mark 

34 0x22 042 00100010 " Double quotes 
(or speech 
marks) 

35 0x23 043 00100011 # Number 

36 0x24 044 00100100 $ Dollar 

37 0x25 045 00100101 % Procenttecken 

38 0x26 046 00100110 & Ampersand 

39 0x27 047 00100111 Single quote 

40 0x28 050 00101000 ( Open 
parenthesis (or 
open bracket) 

41 0x29 051 00101001 ) Close 
parenthesis (or 
close bracket) 

42 Ox2A 052 00101010 * Asterisk 

43 0x2B 053 00101011 + Plus 

44 Ox2C 054 00101100 : Comma 
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45 0x2D 055 00101101 - Hyphen 

46 Ox2E 056 00101110 Period, dot or 
full stop 

47 Ox2F 057 00101111 / Slash or divide 

48 0x30 060 00110000 0 Zero 

49 0x31 061 00110001 1 One 

50 0x32 062 00110010 2 Two 

51 0x33 063 00110011 3 Three 

52 0x34 064 00110100 4 Four 

oe! 0x35 065 00110101 5 Five 

54 0x36 066 00110110 6 Six 

55 0x37 067 00110111 7 Seven 

56 0x38 070 00111000 8 Eight 

57 0x39 071 00111001 9 Nine 

58 0x3A 072 00111010 : Colon 

59 0x3B 073 00111011 : Semicolon 

60 Ox3C 074 00111100 < Less than (or 
open angled 
bracket) 

61 0x3D 075 00111101 = Equals 

62 Ox3E 076 00111110 > Greater than (or 
close angled 
bracket) 

63 Ox3F 077 00111111 ? Question mark 

64 0x40 100 01000000 @ At symbol 

65 0x41 101 01000001 A Uppercase A 

66 0x42 102 01000010 B Uppercase B 

67 0x43 103 01000011 C Uppercase C 

68 0x44 104 01000100 D Uppercase D 

69 0x45 105 01000101 E Uppercase E 

70 0x46 106 01000110 F Uppercase F 

71 0x47 107 01000111 G Uppercase G 

72 0x48 110 01001000 H Uppercase H 

73 0x49 111 01001001 | Uppercase | 

74 Ox4A 112 01001010 J Uppercase J 

75 Ox4B 113 01001011 K Uppercase K 

76 Ox4C 114 01001100 L Uppercase L 

77 0x4D 115 01001101 M Uppercase M 

78 Ox4E 116 01001110 N Uppercase N 

79 Ox4F 117 01001111 O Uppercase O 

80 0x50 120 01010000 P Uppercase P 

81 Ox51 121 01010001 Q Uppercase Q 

82 0x52 122 01010010 R Uppercase R 

83 0x53 123 01010011 S Uppercase S 

84 0x54 124 01010100 i Uppercase T 

85 0x55 125 01010101 U Uppercase U 

86 0x56 126 01010110 V Uppercase V 

87 0x57 127 01010111 W Uppercase W 

88 0x58 130 01011000 X Uppercase X 

89 0x59 131 01011001 Y Uppercase Y 

90 Ox5A 132 01011010 Z Uppercase Z 

91 Ox5B 133 01011011 [ Opening bracket 
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92 Ox5C 134 01011100 \ Backslash 
93 0Ox5D 135 01011101 ] Closing bracket 
94 Ox5E 136 01011110 a: Caret - 
circumflex 
95 Ox5F 137 01011111 Underscore 
96 0x60 140 01100000 Grave accent 
97 0x61 141 01100001 a Lowercase a 
98 0x62 142 01100010 b Lowercase b 
99 0x63 143 01100011 C Lowercase Cc 
100 0x64 144 01100100 d Lowercase d 
101 0x65 145 01100101 e Lowercase e 
102 0x66 146 01100110 f Lowercase f 
103 0x67 147 01100111 g Lowercase g 
104 0x68 150 01101000 h Lowercase h 
105 0x69 151 01101001 Lowercase i 
106 Ox6A 152 01101010 j Lowercase | 
107 0x6B 153 01101011 k Lowercase k 
108 Ox6C 154 01101100 | Lowercase | 
109 0x6D 155 01101101 m Lowercase m 
110 Ox6E 156 01101110 n Lowercase n 
111 Ox6F 157 01101111 O Lowercase oO 
112 0x70 160 01110000 p Lowercase p 
113 0x71 161 01110001 q Lowercase q 
114 0x72 162 01110010 r Lowercase r 
115 0x73 163 01110011 Ss Lowercase Ss 
116 0x74 164 01110100 t Lowercase t 
117 0x75 165 01110101 u Lowercase u 
118 0x76 166 01110110 Vv Lowercase v 
119 Ox77 167 01110111 Ww Lowercase Ww 
120 0x78 170 01111000 X Lowercase x 
121 0x79 171 01111001 y Lowercase y 
122 Ox7A 172 01111010 Z Lowercase Z 
123 0x7B 173 01111011 { Opening brace 
124 Ox7C 174 01111100 | Vertical bar 
125 0x7D 175 01111101 } Closing brace 
126 Ox7E 176 01111110 Equivalency sign 
- tilde 
127 Ox7F 177 01111111 Delete 


The extended ASCII codes (character code 128-255) 

There are several different variations of the 8-bit ASCII table. The table below is 
according to ISO 8859-1, also called ISO Latin-1. Codes 129-159 contain the 
Microsoft® Windows Latin-1 extended characters. 


128 0x80 200 10000000 € Euro sign 

129 0x81 201 10000001 

130 0x82 202 10000010 ; Single low-9 
quotation mark 

131 0x83 203 10000011 f Latin small letter 
f with hook 

132 0x84 204 10000100 . Double low-9 
quotation mark 

133 0x85 205 10000101 Horizontal 
ellipsis 
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134 0x86 206 10000110 Tt Dagger 

135 0x87 207 10000111 ¢ Double dagger 

136 0x88 210 10001000 7 Modifier letter 
circumflex 
accent 

137 0x89 211 10001001 %o Per mille sign 

138 Ox8A 212 10001010 S Latin capital 
letter S with 
caron 

139 0x8B 213 10001011 < Single left- 
pointing angle 
quotation 

140 Ox8C 214 10001100 €E Latin capital 
ligature OE 

141 0Ox8D 215 10001101 

142 Ox8E 216 10001110 Z Latin captial 
letter Z with 
caron 

143 Ox8F 217 10001111 

144 0x90 220 10010000 

145 0x91 221 10010001 ‘ Left single 
quotation mark 

146 0x92 222 10010010 Right single 
quotation mark 

147 0x93 223 10010011 : Left double 
quotation mark 

148 0x94 224 10010100 : Right double 
quotation mark 

149 0x95 225 10010101 ° Bullet 

150 0x96 226 10010110 - En dash 

151 0x97 227 10010111 — Em dash 

152 0x98 230 10011000 i Small tilde 

153 0x99 231 10011001 We Trade mark sign 

154 Ox9A 232 10011010 S Latin small letter 
S with caron 

155 0x9B 233 10011011 > Single right- 
pointing angle 
quotation mark 

156 Ox9C 234 10011100 oe Latin small 
ligature oe 

157 Ox9D 235 10011101 

158 Ox9E 236 10011110 Z Latin small letter 
z with caron 

159 Ox9F 237 10011111 ¥ Latin capital 
letter Y with 
diaeresis 

160 OxA0 240 10100000 Non-breaking 
space 

161 OxAl 241 10100001 i Inverted 
exclamation 
mark 

162 OxA2 242 10100010 ¢ Cent sign 

163 0OxA3 243 10100011 ca Pound sign 
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164 OxA4 244 10100100 boi Currency sign 

165 OxA5 245 10100101 ¥ Yen sign 

166 OxA6 246 10100110 Pipe, Broken 
vertical bar 

167 OxA7 247 10100111 § Section sign 

168 OxA8 250 10101000 . Spacing 
diaeresis - 
umlaut 

169 OxA9 251 10101001 © Copyright sign 

170 OxAA 252 10101010 a Feminine ordinal 
indicator 

171 OxAB 253 10101011 « Left double 
angle quotes 

172 OxAC 254 10101100 zz: Not sign 

173 OxAD 255 10101101 Soft hyphen 

174 OxAE 256 10101110 ® Registered trade 
mark sign 

175 OxAF 257 10101111 7 Spacing macron 
- overline 

176 0xBO 260 10110000 ° Degree sign 

177 OxB1 261 10110001 de Plus-or-minus 
sign 

178 OxB2 262 10110010 ei Superscript two 
- squared 

179 OxB3 263 10110011 2 Superscript 
three - cubed 

180 OxB4 264 10110100 Acute accent - 
spacing acute 

181 OxB5 265 10110101 U Micro sign 

182 OxB6 266 10110110 1 Pilcrow sign - 
paragraph sign 

183 OxB7 267 10110111 Middle dot - 
Georgian 
comma 

184 0OxB8 270 10111000 ; Spacing cedilla 

185 OxB9 271 10111001 Superscript one 

186 OxBA 272 10111010 2 Masculine 
ordinal indicator 

187 OxBB 273 10111011 » Right double 
angle quotes 

188 OxBC 274 10111100 Yq Fraction one 
quarter 

189 OxBD 275 10111101 2 Fraction one half 

190 OxBE 276 10111110 Ya Fraction three 
quarters 

191 OxBF 277 10111111 é Inverted 
question mark 

192 0xCO 300 11000000 A Latin capital 
letter A with 
grave 

193 OxC1 301 11000001 A Latin capital 
letter A with 
acute 
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194 


0xC2 


302 


11000010 


Latin capital 
letter A with 
circumflex 


195 


OxC3 


303 


11000011 


Pi 


Latin capital 
letter A with 
tilde 


196 


0OxC4 


304 


11000100 


Dd; 


Latin capital 
letter A with 
diaeresis 


197 


OxC5 


305 


11000101 


Latin capital 
letter A with 
above 


ring 


198 


OxC6 


306 


11000110 


Latin capital 
letter AE 


199 


OxC7 


307 


11000111 


Latin capital 
letter C with 
cedilla 


200 


OxC8 


310 


11001000 


Latin capital 
letter E with 
grave 


201 


OxC9 


311 


11001001 


Latin capital 
letter E with 
acute 


202 


OxCA 


312 


11001010 


Latin capital 
letter E with 
circumflex 


203 


OxCB 


313 


11001011 


Latin capital 
letter E with 
diaeresis 


204 


OxCC 


314 


11001100 


Latin capital 
letter | with 
grave 


205 


0xCD 


315 


11001101 


Latin capital 
letter | with 
acute 


206 


OxCE 


316 


11001110 


Latin capital 
letter | with 
circumflex 


207 


OxCF 


317 


11001111 


Latin capital 
letter | with 
diaeresis 


208 


0xDO 


320 


11010000 


Latin capital 
letter ETH 


209 


OxD1 


321 


11010001 


zi 


Latin capital 
letter N with 
tilde 


210 


0xD2 


322 


11010010 


Latin capital 
letter O with 
grave 


211 


0xD3 


323 


11010011 


Latin capital 
letter O with 
acute 
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212 


0xD4 


324 


11010100 


Latin capital 
letter O with 
circumflex 


213 


0xD5 


325 


11010101 


Or 


Latin capital 
letter O with 
tilde 


214 


0xD6 


326 


11010110 


O; 


Latin capital 
letter O with 
diaeresis 


215 


216 


OxD7 


0xD8 


327 


330 


11010111 


11011000 


Multiplication 
sign 

Latin capital 

letter O with 

slash 


217 


OxD9 


331 


11011001 


Latin capital 
letter U with 
grave 


218 


OxDA 


332 


11011010 


Latin capital 
letter U with 
acute 


219 


OxDB 


333 


11011011 


Latin capital 
letter U with 
circumflex 


220 


0xDC 


334 


11011100 


(amt | 


Latin capital 
letter U with 
diaeresis 


221 


OxDD 


335 


11011101 


Latin capital 
letter Y with 
acute 


222 


OxDE 


336 


11011110 


Latin capital 
letter THORN 


223 


224 


OxDF 


OxEO 


337 


340 


11011111 


11100000 


Latin small letter 
sharp s - ess-zed 
Latin small letter 
a with grave 


225 


OxE1 


341 


11100001 


Latin small letter 
a with acute 


226 


OxE2 


342 


11100010 


Latin small letter 
a with 
circumflex 


227 


OxE3 


343 


11100011 


Latin small letter 
a with tilde 


228 


OxE4 


344 


11100100 


Latin small letter 
a with diaeresis 


229 


OxE5 


345 


11100101 


Latin small letter 
a with ring 
above 


230 


OxE6 


346 


11100110 


Latin small letter 
ae 


231 


OxE7 


347 


11100111 


Latin small letter 
c with cedilla 


232 


OxE8 


350 


11101000 


Latin small letter 
e with grave 
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233 OxE9 351 11101001 é Latin small letter 
e with acute 

234 OxEA 352 11101001 é Latin small letter 
e with 
circumflex 

235 OxEB 353 11101011 é Latin small letter 
e with diaeresis 

236 OxEC 354 11101100 ] Latin small letter 
i with grave 

237 OxED 355 11101101 f Latin small letter 
i with acute 

238 OxEE 356 11101110 i Latin small letter 
i with circumflex 

239 OxEF 357 11101111 1 Latin small letter 
i with diaeresis 

240 OxFO 360 11110000 6 Latin small letter 
eth 

241 OxF1 361 11110001 n Latin small letter 
n with tilde 

242 OxF2 362 11110010 fe) Latin small letter 
o with grave 

243 OxF3 363 11110011 6 Latin small letter 
o with acute 

244 OxF4 364 11110100 6 Latin small letter 
o with 
circumflex 

245 OxF5 365 11110101 fe) Latin small letter 
o with tilde 

246 OxF6 366 11110110 fo) Latin small letter 
o with diaeresis 

247 OxF7 367 11110111 + Division sign 

248 OxF8 370 11111000 i) Latin small letter 
o with slash 

249 OxF9 371 11111001 U Latin small letter 
u with grave 

250 OxFA 372 11111010 U Latin small letter 
u with acute 

251 OxFB 373 11111011 v Latin small letter 
u with 
circumflex 

252 OxFC 374 11111100 U Latin small letter 
u with diaeresis 

253 OxFD 375 11111101 y Latin small letter 
y with acute 

254 OxFE 376 11111110 b Latin small letter 
thorn 

255 OxFF 377 11111111 y Latin small letter 


y with diaeresis 
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Virtual key codes 
The following table shows the symbolic constant names, hexadecimal values, and 
mouse or keyboard equivalents for the virtual-key codes used by the system. The 


codes are listed in numeric order. 


Costant Description Decimal value Hexadecimal 
value 

VK_LBUTTON Left mouse i 0x01 

button 
VK_RBUTTON Right mouse 2 0x02 

button 
VK_CANCEL Control-break 3 0x03 

processing 
VK_MBUTTON Middle mouse 4 0x04 

button (three- 

button mouse) 
VK_XBUTTON1 X1 mouse button | 5 0x05 
VK_XBUTTON2 X2 mouse button | 6 0x06 
- Undefined 7 0x07 
VK_BACK BACKSPACE key 8 0x08 
VK_TAB TAB key 9 0x09 
- Reserved 10-11 0x0A-0x0B 
VK_CLEAR CLEAR key 12 0x0C 
VK_RETURN ENTER key 13 0x0D 
- Undefined 14-15 OxOE-0x0F 
VK_SHIFT SHIFT key 16 0x10 
VK_CONTROL CTRL key 17 Ox11 
VK_MENU ALT key 18 0x12 
VK_PAUSE PAUSE key 19 0x13 
VK_CAPITAL CAPS LOCK key 20 0x14 
VK_KANA IME Kana mode 21 0x15 
VK_HANGUEL IME Hanguel 21 Ox15 

mode 

(maintained for 

compatibility; use 

VK_HANGUL) 
VK_HANGUL IME Hangul mode | 21 0x15 
- Undefined 22 0x16 
VK_JUNJA IME Junja mode 23 0x17 
VK_FINAL IME final mode 24 0x18 
VK_HANJA IME Hanja mode 29 0x19 
VK_KANIJI IME Kanji mode 25 0x19 
- Undefined 26 Ox1A 
VK_ESCAPE ESC key 27 0x1B 
VK_CONVERT IME convert 28 Ox1C 
VK NONCONVERT IME nonconvert 29 0x1D 
VK_ ACCEPT IME accept 30 Ox1E 
VK_MODECHANGE IME mode change | 31 Ox1F 

request 
VK_SPACE SPACEBAR a2 0x20 
VK_PRIOR PAGE UP key 33 0x21 
VK_NEXT PAGE DOWN key _ | 34 0x22 
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VK_END END key 35 0x23 
VK_HOME HOME key 36 0x24 
VK_LEFT LEFT ARROW key | 37 0x25 
VK_UP UP ARROW key 38 0x26 
VK_RIGHT RIGHT ARROW 39 0x27 
key 
VK_DOWN DOWN ARROW 40 0x28 
key 
VK_SELECT SELECT key 41 0x29 
VK_PRINT PRINT key 42 Ox2A 
VK_EXECUTE EXECUTE key 43 Ox2B 
VK_SNAPSHOT PRINT SCREEN 44 Ox2C 
key 
VK_INSERT INS key 45 Ox2D 
VK_DELETE DEL key 46 Ox2E 
VK_HELP HELP key 47 Ox2F 
VK_KEY_0 0 key 48 0x30 
VK_KEY_1 1 key 49 0x31 
VK_KEY 2 2 key 50 0x32 
VK_KEY_ 3 3 key 51 0x33 
VK_KEY 4 4 key 52 0x34 
VK_KEY 5 5 key 53 0x35 
VK_KEY_6 6 key 54 0x36 
VK_KEY 7 7 key 55 0x37 
VK_KEY_ 8 8 key 56 0x38 
VK_KEY 9 9 key 57 0x39 
- Undefined 58-64 0x3A-40 
VK_KEY A A key 65 0x41 
VK_KEY B B key 66 0x42 
VK_KEY C C key 67 0x43 
VK_KEY D D key 68 0x44 
VK_KEY_E E key 69 0x45 
VK_KEY F F key 70 0x46 
VK_KEY G G key 71 0x47 
VK_KEY_H H key 72 0x48 
VK_KEY | | key 73 0x49 
VK_KEY J J key 74 Ox4A 
VK_KEY K K key 75 0Ox4B 
VK_KEY_L L key 76 Ox4C 
VK_KEY M M key 77 0x4D 
VK_KEY_N N key 78 Ox4E 
VK_KEY O O key 79 Ox4F 
VK_KEY P P key 80 0x50 
VK_KEY Q Q key 81 Ox51 
VK_KEY R R key 82 0x52 
VK_KEY_S S key 83 0x53 
VK_KEY_T T 84 0x54 
VK_KEY U U key 85 0x55 
VK_KEY V V key 86 0x56 
VK_KEY W W key 87 0x57 
VK_KEY X X key 88 0x58 
VK_KEY_Y Y key 89 0x59 
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VK_KEY Z Z key 90 Ox5A 

VK_LWIN Left Windows key | 91 Ox5B 
(Natural 
keyboard) 

VK_RWIN Right Windows 92 0Ox5C 
key (Natural 
keyboard) 

VK_APPS Applications key 93 0x5D 
(Natural 
keyboard) 

- Reserved 94 Ox5E 

VK_SLEEP Computer Sleep 95 Ox5F 
key 

VK_NUMPADO Numeric keypad 96 0x60 
0 key 

VK_NUMPAD1 Numeric keypad 97 0x61 
1 key 

VK_NUMPAD2 Numeric keypad 98 0x62 
2 key 

VK_NUMPAD3 Numeric keypad 99 0x63 
3 key 

VK_NUMPAD4 Numeric keypad 100 0x64 
4 key 

VK_NUMPAD5 Numeric keypad 101 0x65 
5 key 

VK_NUMPAD6 Numeric keypad 102 0x66 
6 key 

VK_NUMPAD7 Numeric keypad 103 0x67 
7 key 

VK_NUMPAD8 Numeric keypad 104 0x68 
8 key 

VK_NUMPAD9 Numeric keypad 105 0x69 
9 key 

VK_ MULTIPLY Multiply key 106 Ox6A 

VK_ADD Add key 107 0Ox6B 

VK_SEPARATOR Separator key 108 Ox6C 

VK_ SUBTRACT Subtract key 109 0x6D 

VK_DECIMAL Decimal key 110 Ox6E 

VK_DIVIDE Divide key 111 Ox6F 

VK_F1 Fl key 112 0x70 

VK_F2 F2 key 113 0x71 

VK_F3 F3 key 114 0x72 

VK_F4 F4 key 115 0x73 

VK_F5 F5 key 116 0x74 

VK_F6 F6 key 117 0x75 

VK_F7 F7 key 118 0x76 

VK_F8 F8 key 119 Ox77 

VK_F9 FQ key 120 0x78 

VK_F10 F10 key 121 0x79 

VK F1l F1l1 key 122 Ox7A 

VK _F12 F12 key 123 0x7B 

VK_F13 F13 key 124 Ox7C 

VK _F14 F14 key 125 0x7D 
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VK_F15 F15 key 126 Ox7E 
VK_F16 F16 key 127 Ox7F 
VK_F17 F17 key 128 0x80 
VK_F18 F18 key 129 0x81 
VK_F19 F19 key 130 0x82 
VK_F20 F20 key 131 0x83 
VK_F21 F21 key 132 0x84 
VK_F22 F22 key 133 0x85 
VK_F23 F23 key 134 0x86 
VK_F24 F24 key 135 0x87 
- Unassigned 136-143 0x88-8F 
VK_NUMLOCK NUM LOCK key 144 0x90 
VK_SCROLL SCROLL LOCK key | 145 0x91 
VK_OEM_FJ JISHO OEM Jisho 146 0x92 
VK_OEM_FJ MASSHOU_ | OEM Mashu 147 0x93 
VK_OEM_FJ TOUROKU | OEM Touroku 148 0x94 
VK_OEM_FJ LOYA OEM Loya 149 0x95 
VK_OEM_FJ ROYA OEM Roya 150 0x96 
- Unassigned 151-159 0x97-9F 
VK_LSHIFT Left SHIFT key 160 OxAO 
VK_RSHIFT Right SHIFT key 161 OxAl1 
VK_LCONTROL Left CONTROL 162 OxA2 
key 
VK_RCONTROL Right CONTROL 163 0OxA3 
key 
VK_LMENU Left MENU key 164 OxA4 
VK_RMENU Right MENU key 165 OxA5 
VK_ BROWSER BACK Browser Back key | 166 OxA6 
VK_BROWSER_FORWA | Browser Forward | 167 OxA7 
RD key 
VK_BROWSER REFRES | Browser Refresh 168 OxA8 
H key 
VK BROWSER STOP Browser Stop key | 169 OxA9 
VK_BROWSER_SEARCH | Browser Search 170 OxAA 
key 
VK_BROWSER _FAVORI | Browser Favorites | 171 OxAB 
TES key 
VK_BROWSER_HOME Browser Start and | 172 OxAC 
Home key 
VK_VOLUME_ MUTE Volume Mute key | 173 OxAD 
VK_VOLUME_ DOWN Volume Down key | 174 OxAE 
VK_VOLUME_UP Volume Up key 175 OxAF 
VK_MEDIA_NEXT_TRAC | Next Track key 176 0xBO 
K 
VK_MEDIA_PREV_TRAC | Previous Track 177 OxB1 
K key 
VK_MEDIA_ STOP Stop Media key 178 OxB2 
VK_MEDIA_PLAY_PAUS | Play/Pause Media | 179 OxB3 
E key 
VK_LAUNCH _ MAIL Start Mail key 180 OxB4 
VK_LAUNCH_MEDIA SE | Select Media key | 181 OxB5 


LECT 
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VK_LAUNCH_APP1 


Start Application 
1 key 


182 


OxB6 


VK_LAUNCH_APP2 


Start Application 
2 key 


183 


OxB7 


Reserved 


184-185 


0OxB8-B9 


VK_OEM_1 


VK_OEM_PLUS 


Used for 
miscellaneous 
characters; it can 


vary by keyboard. 


For the US 
standard 
keyboard, the ';:' 
key 

For any 
country/region, 
the '+' key 


186 


187 


OxBA 


OxBB 


VK_OEM_COMMA 


For any 
country/region, 
the ',' key 


188 


OxBC 


VK_OEM_MINUS 


For any 
country/region, 
the '-' key 


189 


OxBD 


VK_OEM_PERIOD 


For any 
country/region, 
the '.' key 


190 


OxBE 


VK_OEM_2 


Used for 
miscellaneous 
characters; it can 


vary by keyboard. 


For the US 
standard 
keyboard, the '/?' 
key 


191 


OxBF 


VK_OEM 3 


Used for 
miscellaneous 
characters; it can 


vary by keyboard. 


For the US 
standard 
keyboard, the 
'\~' key 


192 


OxCO 


VK_ABNT Cl 


Abnt C1 


193 


OxC1 


VK_ABNT_C2 


Abnt C2 


194 


0xC2 


Reserved 


195-215 


0xC3-D7 


Unassigned 


216-218 


0xD8-DA 
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VK_OEM 4 


Used for 
miscellaneous 
characters; it can 
vary by keyboard. 


For the US 
standard 
keyboard, the '[{' 
key 


219 


OxDB 


VK_OEM_5 


Used for 
miscellaneous 
characters; it can 
vary by keyboard. 


For the US 
standard 
keyboard, the '‘\|' 
key 


220 


0xDC 


VK_OEM 6 


Used for 
miscellaneous 
characters; it can 
vary by keyboard. 


For the US 
standard 
keyboard, the ']}' 
key 


221 


OxDD 


VK_OEM_7 


Used for 
miscellaneous 
characters; it can 
vary by keyboard. 


For the US 
standard 
keyboard, the 
‘single-quote/dou 
ble-quote' key 


222 


OxDE 


VK_OEM 8 


Used for 
miscellaneous 
characters; it can 
vary by keyboard. 
Usually the ‘§ !’ 
key. 


223 


OxDF 


Reserved 


224 


OxEO 


VK_OEM_AX 


Ax 


225 


OxE1 


VK_OEM_102 


Either the angle 
bracket key or 
the backslash key 
on the RT 102- 
key keyboard. 
ee 


226 


OxE2 


VK_ICO_HELP 


ICoHIp 


227 


OxE3 
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VK_ICO_00 Ico00, VK_ICO_00 | 228 OxE4 

virtual code 

produces '00' 

(two zeros) when 

pressed. Windows 

does not allow 

mapping of 

arbitrary Unicode 

codepoints to this 

VK code. 
VK_PROCESSKEY IME PROCESS key | 229 OxE5 
VK_ICO_ CLEAR IcoClr key 230 OxE6 
VK_PACKET Used to pass 231 OxE7 

Unicode 

characters as if 

they were 

keystrokes. The 

VK_PACKET key is 

the low word of a 

32-bit Virtual Key 

value used for 

non-keyboard 

input methods. 

For more 

information, see 

Remark in 

KEYBDINPUT, 

Sendinput, 

WM_KEYDOWN, 

and WM_KEYUP 
- Unassigned 232 OxE8 
VK_OEM_RESET OEM Reset key 233 OxE9 
VK_OEM_JUMP OEM Jump key 234 OxEA 
VK_OEM PA1 OemPal 235 OxEB 
VK_ OEM PA2 OemPa2 236 OxEC 
VK_OEM PA3 OemPa3 237 OxED 
VK_OEM_WSCTRL OEM WsCtrl 238 OxEE 
VK_ OEM CUSEL OEM Cu Sel 239 OxEF 
VK_OEM_ATIN OEM Attn 240 OxFO 
VK_OEM FINISH OEM Finish 241 OxF1 
VK_OEM COPY OEM copy 242 OxF2 
VK_OEM AUTO OEM Auto 243 OxF3 
VK_OEM ENLW OEM Enlw 244 OxF4 
VK_OEM_BACKTAB OEM Back Tab 245 OxF5 
VK_ATITN Attn key 246 OxF6 
VK_CRSEL CrSel key 247 OxF7 
VK_EXSEL ExSel key 248 OxF8 
VK_EREOF Erase EOF key 249 OxF9 
VK_PLAY Play key 250 OxFA 
VK_ZOOM Zoom key 251 OxFB 
VK_NONAME NoName 252 OxFC 
VK PAIL PA1 key 253 OxFD 
VK_OEM CLEAR Clear key 254 OxFE 
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GTASA_CRC32 hashing algorithm 

This type of hashing is used to convert model and texture names into a small 
datum (4-byte integer) in memory. They are identified subsequently by 
comparison with existing hashes. Character keypresses are also hashed and 
compared to hashes of cheat strings. 


C++ code 


const unsigned long GTASA CRC32 table[256] = { 


0x00000000, 
0x076DC419, 
OxOEDB8832, 
0x09B64C2B, 
0x1DB71064, 
O0x1ADAD47D, 
0x136C9856, 
0x14015C4F, 
0x3B6E20C8, 
O0x3CO3E4D1, 
Ox35B5A8FA, 
0x32D86CE3, 
O0x26D930AC, 
0x21B4F4B5, 
O0x2802B89E, 
Ox2F6F7C87, 
0x76DC4190, 
0x71B18589, 
0x7807C9A2, 
Ox7F6AQDBB, 
Ox6B6B51F4, 
Ox6CO695ED, 
Ox65BOD9C6, 
0x62DD1DDF, 
0x4DB26158, 
Ox4ADFA541, 
0x4369E96A, 
0x44042D73, 
0x5005713C, 
0x5768B525, 
Ox5EDEF9OE, 
0x59B33D17, 
OxEDB88320, 
O0xEAD54739, 
0xE3630B12, 
OxE40ECFOB, 
OxFOOF9344, 
0xF762575D, 
OxFED41B76, 
OxFOB9ODFO6F, 
OxD6D6A3E8, 
0xD1BB67F1, 
OxD80D2BDA, 
OxDF60EFC3, 
0xCB61B38C, 
0xCC0C7795, 
OxC5BA3BBE, 
OxC2D7FFA7, 
0x9B64C2B0, 
0x9CO906A9, 
Ox95BF4A82, 
Ox92D28E9B, 


0x77073096, 
Ox706AF48F, 
0x79DCB8A4, 
0x7EB17CBD, 
Ox6ABO20F2, 
Ox6DDDE4EB, 
O0x646BA8CO, 
0x63066CD9, 
0x4C69105E, 
0x4B04D447, 
0x42B2986C, 
Ox45DF5C75, 
0x51DE003A, 
0x56B3C423, 
0x5F058808, 
0x58684C11, 
0x01DB7106, 
OxO6B6B51F, 
OxOFOOF934, 
0x086D3D2D, 
0x1C6C6162, 
0x1B01A57B, 
0x12B7E950, 
0x15DA2D49, 
Ox3AB551CE, 
0x3DD895D7, 
Ox346ED9FC, 
0x33031DE5, 
0x270241AA, 
0x206F85B3, 
0x29D9C998, 
Ox2EB40D81, 
Ox9ABFB3B6, 
Ox9DD277AF, 
0x94643B84, 
O0x9309FF9D, 
0x8708A3D2, 
0x806567CB, 
0x89D32BE0, 
Ox8EBEEFF9, 
0xA1D1937E, 
OxA6BC5767, 
OxAFOA1B4C, 
OxA867DF55, 
0xBC66831A, 
0xBBO0B4703, 
OxB2BD0B28, 
OxB5DOCF31, 
OxEC63F226, 
OxEBOE363F, 
OxE2B87A14, 
OxE5D5BEOD, 


OxEEQE612C, 
0xE963A535, 
OxEQD5E91E, 
OxE7B82D07, 
0xF3B97148, 
OxF4D4B551, 
OxFD62F97A, 
OxFAOQF3D63, 
0xD56041E4, 
O0xD20D85FD, 
OxDBBBC9D6, 
OxDCD60DCF, 
0xC8D75180, 
OxCFBA9599, 
OxC60CD9B2, 
0xC1611DAB, 
0x98D220BC, 
Ox9FBFE4A5, 
Ox9609A88E, 
0x91646C97, 
0x856530D8, 
0x8208F4C1, 
Ox8BBEB8EA, 
0x8CD37CF3, 
0xA3BC0074, 
OxA4D1C46D, 
0xAD678846, 
OxAAOQA4C5F, 
OxBEQB1010, 
0xB966D409, 
0xBOD09822, 
0xB7BD5C3B, 
0x03B6E20C, 
0x04DB2615, 
OxOD6D6A3E, 
OxOAQO0AE27, 
Ox1E01F268, 
0x196C3671, 
Ox10DA7A5A, 
0x17B7BE43, 
0x38D8C2C4, 
Ox3FB506DD, 
0x36034AF6, 
Ox316E8EEF, 
Ox256FD2A0, 
0x220216B9, 
Ox2BB45A92, 
Ox2CD99E8B, 
0x756AA39C, 
0x72076785, 
Ox7BB12BAE, 
0x7CDCEFB7, 


0x990951BA, 
0x9E6495A3, 
0x97D2D988, 
Ox90BF1D91, 
Ox84BE41DE, 
0x83D385C7, 
Ox8A65C9EC, 
Ox8DO80DF5, 
0xA2677172, 
OxA50AB56B, 
OxACBCF940, 
OxABD13D59, 
OxBFD06116, 
OxB8BDA5OF, 
OxB10BE924, 
0xB6662D3D, 
OxEFD5102A, 
OxE8B8D433, 
OxE10E9818, 
0xE6635C01, 
OxF262004E, 
OxF50FC457, 
OxFCB9887C, 
OxFBD44C65, 
OxD4BB30E2, 
OxD3D6F4FB, 
OxDA60B8DO, 
OxDDOD7CC9, 
0xC90C2086, 
OxCE61E49F, 
OxC7D7A8B4, 
OxCOBA6CAD, 
0x74B1D29A, 
0x73DC1683, 
Ox7A6A5AA8 , 
0x7D079EB1, 
0x6906C2FE, 
Ox6E6B06E7, 
Ox67DD4ACC, 
Ox60BO08ED5, 
Ox4FDFF252, 
0x48B2364B, 
0x41047A60, 
0x4669BE79, 
0x5268E236, 
0x5505262F, 
Ox5CB36A04, 
Ox5BDEAE1D, 
0x026D930A, 
0x05005713, 
0x0CB61B38, 
OxOBDBDF21, 
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@x86D3D2D4, 
@x81BE16CD, 
@x88085AE6, 
Ox8F659EFF, 
OxAQOAE278, 
QxA7672661, 
@xAED16A4A, 
@xAQBCAE53, 
@xBDBDF21C, 
@xBAD03605, 
0xB3667A2E, 
0xB40BBE37, 
}; 


unsigned long int _ cdecl GTASA CRC32 string (unsigned 


i 


// Example of use: 


OxF1D4E242, 
OxF6B9265B, 
OxFFOF6A70, 
OxF862AE69, 
OxD70DD2EE, 
0xD06016F7, 
OxD9D65ADC, 
OxDEBB9EC5, 
OxCABAC28A, 
0xCDD70693, 
OxC4614AB8, 
OxC30C8EA1, 


Ox68DDB3F8, 
Ox6FBO77E1, 
0x66063BCA, 
Ox616BFFD3, 
0x4E048354, 
0x4969474D, 
Ox40DFOB66, 
0x47B2CF7F, 
0x53B39330, 
0x54DE5729, 
0x5D681B02, 
Ox5A05DF1B, 


Ox1FDA836E, 
0x18B74777, 
0x11010B5C, 
Ox166CCF45, 
0x3903B3C2, 
Ox3E6E77DB, 
0x37D83BFO0, 
Ox30B5FFE9, 
Ox24B4A3A6, 
0x23D967BF, 
Ox2A6F2B94, 
Ox2D02EF8D 


// GTASA_CRC32 string( (unsigned char*) "LANDSTK") 


register unsigned long crc; 
crc = OxFFFFFFFF; 


while (*string) 


{ 
cre = crc >> 8 * GTASA CRC32_table[*string 
*string++; 
} 
return crc; 


char *string) 


“~ (crc & OxFF)]; 
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Environment 


The basic principles 


Units 
One point in game is supposed to be one meter. That's the way all the factors 
should be scaled into. 


A game can place objects only on limited area called a map area and this area is 
surrounded by an ocean. 


Map limits: 
X: -3000.0 to 3000.0 
Y: -3000.0 to 3000.0 


Distance 

While playing a game knows coordinates of player and searches for objects 
around to render. It is good to know game loads collisions for less than 180.0 
points around player (not camera location) and loads additional LOD objects if 
distance between player and target object is higher than 300.0 map points. 


Following table presents it: 


Player Distance between | Target COL Collision isn*t 
is higher than collision working there. 
180.0 and For example 


camera was 
attached on 
vehicle and this 
vehicle drove too 
far away, then it 
will collapse even 
though model is 


visible yet. 
Player Distance between | Target model LOD (low quality) 
is higher than object will be 
300.0 and loaded and 


shown in game 


Basic map file - external files to load 
The game loads two text files whose names are hardcoded - data\default.dat & 
data\gta.dat. 


Lets name it “Basic map file”. 


These files refer to other files in game directories to load such as IMG archives 
with binary models, textures or collisions, COL files, item definition files, item 
placement files and so on. Paths used in basic map entries are relative to 
executable location. 
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default.dat is the first Basic map file loaded. It is followed by gta.dat. 


It is important for game to load IMG archives before IDE using models and 
textures, and IDE before IPL using entries from IDE, because the game loads 
them in order as it is in basic map file. 


Lines can be commented by the # sign at the beginning. 


IMG 
IMG archive contains: 


e .dff models 

e .txd texture archives 

e .col collision archives 

e .ipl binary file, map placement 

e .dat cutscene camera movements 

e .ifp animations for peds or objects 

e .rrr path information for mission script 
e .scm scripts 

e .cut cutscene text data, properties 


Example /MG: 


| 
| IMG DATA\PATHS\ 


| CARREC . IMG 


IDE 
These entries link to item definition files which define objects which could be 
used in IPL. 


Example /DE: 


| 
| IDE DATA\ 


| VEHICLES . IDE 


COLLISION 
This keyword is used to define external collision files which are placed in game 
directories. 


Number sets up what map part COL belongs to. It is town number. 


Number of COL Description 
map part 
whole map, city of the city 
Z first town (usually Los 
Santos) 
2 second town (usually San 
Fierro) 
3 third town (usually Las 
Venturas) 
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IPL and MAPZONE 

These keywords are used to link to IPL-style item placement and zone files. 
Although MAPZONE is usually used for .zon files with zone corners it is parsed the 
same way as IPL. 


Example /PL: 


Example MAPZONE: 


| 
|MAPZONE DATA\ 


/MAP.. ZON 


—— 


TEXDICTION 
These entries link to external, mostly generic model files. 


Example TEXDICTION: 


| 
| TEXDICTION MODELS\GENERIC\ | 
| WHEELS. TXD | 


MODELFILE 
These entries link to external, mostly generic texture archives. 


Example MODELFILE: 


| 
|MODELFILE MODELS\GENERIC\ 


WHEELS . DFF 


HIERFILE 
There is no hier file used in standard GTA San Andreas and structure is unknown. 


Example H/ERFILE: 


| 
| HIERFILE MODELS\ 


EXAMPLE. HIER 


_——— io | 


EXIT 
This command stops any further processing of the gta.dat file. 


Example EXIT: 


EXIT 
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Declaring objects (IDE and dynamic object files) 
Every object needs to be declared before the use. Dynamic objects which could 
be moved or destroyed have to be described in special files. 


IDE files - item definition 

They declare each item which must have unique ID, not declared before. Each 
item is identified by unique ID in range of 0-20000. Firstly IDE files need to be 
defined in basic map files; it is described on page 43. 


Trying to use already occupied ID will crash the game. 


IDE files are split into sections and their format is as follows: 


# This line is commented and skipped by the GTA SA parser 
objs 

16000, drvin screen, con drivein, 150, 4 

16001, drvin_projhut, con _drivein, 100, 0 

end 

anim 

16776 ,des cockbody ,desn2 peckers ,countn2 ,290 ,0 

16777 ,des stmotsigbasl ,des southtown ,countn2 ,200 ,0 
16778 ,des_ufosign ,des_ufoinn ,countn2 ,150 ,0 

16779 ,ufo light02 ,ufo bar ,countn2 ,20 ,4 

16780 ,ufo light03 ,ufo bar ,countn2 ,20 ,4 

16781 ,cn2_ ringking ,des stownstrip2 ,countn2 ,150 ,128 
16782 ,a51_ radar_scan ,a51 detailstuff ,countn2 ,20 ,4 
end 

Comments are started with a # sign at a beginning of the line and ignored by the 
GTA SA parser. 


CARS 
This section is used to define vehicles and some of their properties. 


All vehicles | car, trailer, quad, mtruck, bmx and 
| bike. NOT boats 

%d Id, %Ss ModelName, %s TxdName, | xd WheelID, %f 

%S Type, %S HandlingId, %s |WheelScale Front, %f 

GameName, %s Anims, %sS Class, %d | WheelScale Rear, %d Argument15 

Frequency, %x Flags, %d | 

Comprules, | 

Explanation of arguments: 


Argument Type Description 
ID integer Unique object ID 
ModelName string Name of the .dff model 
file without extension. | 
TxdName string Name of the .txd texture 
dictionary without 
extension. 
Type string Type of vehicle, given as 
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string. 
Types. 


HandlingId 


string 


Name corresponding to its | 
handling data in the 
handling.cfg file. 


GameName 


string 


Name corresponding to its 

GXT entry, case sensitive 

and must be 7 characters 

or less. 

Invalid name will not show 
up in the game. 


Anims 


string 


Name of the .ifp 
animation file without 
extension. It is mainly 
used on bikes. null to 
ignore this argument and 
use default animation. 


Class 


string 


Class of the vehicle - it 
specifies the class of 
driver which will be 
created in car if car has 
been spawned in random 
traffic. GTA SA will search 
for ped with that class as 
a driver. 


Frequency 


integer 


Influences a frequency of 
the vehicle spawning 
randomly on the streets. 


WheeLID 


integer 


Wheel index, needs to be 
-1 for vehicles to use 
wheel model defined in 
the vehicle's model 
(wheels.dff is no longer 
used) 


WheelScale Front 


float 


Scale of front wheels and 
collision models for types 
car, trailer, quad, mtruck, 
bmx and bike 


WheelScale Rear 


float 


Scale of rear wheels and 
collision models for types 
car, trailer, quad, mtruck, 
bmx and bike 


Argument15 


integer 


Unknown value. For most 
vehicles it is 0, or -1 
regardless of Type. 


For the Flash, Elegy, 
Stratum, Jester and 
Uranus this value is 1. For 
the Remington, Blade, 
Slamvan, Savanna, 
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rar T Broadway and Tornado 


| | this value is 2. 


Example: 

cars 

# car and all other vehicles expect boats are defined by 15 

parameters 

400, landstal, landstal, car, LANDSTAL, LANDSTK, null, 
normal, 10, 0, 0, -1, 0.768, 0.768, 0 

# only boats are defined by 11 parameters 

430, predator, predator, boat, PREDATOR, PREDATR, null, 
ignore, 10, 0, 0 

end 

PATH 


GTA San Andreas introduces new binary format and path section is already 
unused. 


path header format 


%d Argument1, %d Argument2, %s Argument3 


Sscanf pattern is messed up in GTA SA and good pattern from GTA VC is 
described below. 


path data format 


——— | 


%d Type, %d Next, %d Argument3, %f directionX, %f directionY, ‘%f 
directionZ, ‘%f Median, %d LeftTrafficLanes, %d RightTrafficLanes, 
%d SpeedLimit, %d Access, %f SpawnFrequency 


Explanation of arguments: 


Argument Type a Description 
Type integer 0 | Null node. 
1 | External node. 
2 | Internal node. 
Next integer -1 | Do not link to any other 
| node in this group. 
0tol1l ! Link to this node number in 
| this group. 
Argument3 integer 0 | Unknown argument with 
| value 0 in all standard path 
| entries. 
directionx float -48000.0 ‘| (X) Position of node East 
to | from environment center 
48000.0 __| multiplied by 16.0 
directionY float Above | (Y) Position of node South 
100.0 | from environment center 
(lowest , multiplied by 16.0 
height, | 
playeris | 
| respawne | | 
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eine eae al ta ere ys ea SD EIOW) <3 et i ea ako | 
directionZ float l (Z) Position of node 
| upwards from environment 


| center multiplied by 16.0 


Median float More than Beware real width from 
0.0 | game map is multiplied by 
| 16.0 here. 


: For vehicles: Width of the 
| divider between left lanes 
| and right lanes 

| For peds: Width of the line 
| they walk down. 

| For boats: Unknown 

| purpose. 

Number of traffic lanes to 


| the left of this node. 


LeftTrafficLanes , integer 


RightTrafficLane | integer | Number of traffic lanes to 
S | the right of this node. 
SpeedLimit integer Values: |; The node speed limit 

0 | slow - typical polish road 

1 l'medium - in cities 

2 | fast - on highways 
Access integer lst bit: 1 | backroad bit, cars don't 


| drive onto the backroads 
: (turn around if necessary) 
| and cop cars don't get 
| spawned on them either 
| a cet has 
wanted stars. 
2nd bit: 2 : police roadblock bit, police 
| can set-up roadblocks only 
| on nodes with the 2nd bit 
| set; this flag gets also 
| accessed when the game 
| sets-up traffic lights on 
| start-up so there might be 
|________|interdependencies there. __| 
3rd bit: 4 | restricted access area. Cars 
| with a certain flag set (at 
| +168 into the vehicle 
| block, 3rd bit ("4")) cannot 
| enter the path just as 
; normal vehicles do not 
| enter backroads (see 
| above). You can set the 
! flag to true for a specific 
| vehicle with the 0428 
| opcode 
SpawnFrequency float More than | Spawn frequency, 0.0 
0.0 to 1.0 : means never spawn, 1.0 


| means always spawn when | 
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p---------- oo | ‘Tthe node has been chosen _ | 


| | | 
| | | for a Spawn | 


General appearance 

There are some things which make a game look better or worse. Although every 
model and texture how the game looks, there are still some some files 
controlling a world independly of where is player is player. It concerns to sky or 
particles which appear almost everywhere. 


EnbSeries 


Introduction 
ENBSeries is graphical plugin made by Russian modder BorisVorontsov. 


It adds car reflections, screen space ambient occlusions and indirect lightning 
(SSAO, SSIL), bloom, motion blur, shadows, water to GTA San Andreas. 


Too see how much it changes GTA SA appearance compare a pictures below: 


Without ENBSeries: 


With EnbSeries 
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Configuration of enbseries.ini is stored in enbseries.ini file and can be edited in 
any of text editors. 


PROXY 

EnableProxyLibrary [boolean] - when activated, load 3rd party library (other 
modification) by the ENBSeries at game start, path to it written in parameter 
ProxyLibrary. This allow to solve problem with multiple d3d9.dll files that can't be 
used at once without special loaders, but if their internal code was made not 
correct to hande loading not directly by game, this will result in game crash or 
just not workable. If you can't load some useful library with ENBSeries, there is an 
other way, to replace original d3d9.dll in Windows System32 folder with 
ENBSeries d3d9.dll, but it's for advanced users, who knows how to bypass file 
recovering system, this way 3rd party d3d9.dll will be in game folder and will load 
ENBSeries like original library and ENBSeries must to load that original d3d9.dll 
as proxy from some other path user defined, in this case InitProxyFunctions must 
to be set 1. 


InitProxyFunctions [boolean] - connect to functions of 3rd party library, if it's 

true d3d9.dll library that initialize some 3d objects inside or modify them. Some 
modifications don't need this to be enabled, they activating when loading, but if 
proxy library not works, try to set this parameter to 1. 


ProxyLibrary [boolean] - file name of 3rd party library. May be full path, but it 
must not contain special symbols, unicode characters (japaneese, chineese) and 
limited by length. Only one library allowed currently. 


GLOBAL 
It configures general settings of EnbSeries. 
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Explanation of parameters: 


UseEffect [boolean] - if set to 1, ENBSeries will be automatically enabled when a 
game is opened or resumed after the minimization. 


AlternativeDepth [boolean] - when this is enabled, information about the image 
depth for some of the effects are rendered through the mist, which can improve 
performance in certain situations, but not all video cards draw fog with full 
precision. Only DX10 and DX11 cards can do it - GF 8xxx, 9xxx, GTX and Radeon 
HD 2000-5970. If you see large lines on OBJECTS, disable this parameter. 


AllowAntialias [boolean] - enables antialiasing setting from game also on the 
effects of ENB. If antialiasing is enabled or disabled in the panel display drivers, 
this parameter will not work, turn off the antialiasing setting. 


BugFixMode [integer] [0...5] - every value fixes the unsupported option or a bug 
in driver or hardware. Values from 0 to 5 are HDR texture formats: 0 (R32G32F)- 
high quality and average yield, 1 (R32F)-high quality and high efficiency, 2 
(A32R32G32B32F)-high quality and low productivity, 3 (R16F)-low quality and 
very high performance, 4 (R16G16F)-low quality and high efficiency, 5 
(A16R16G16B16F)-low quality and middle performance. 


SkipShaderOptimization [boolean] - disables optimization when compiling 
shader, may help to eliminate errors. Try to enable this parameter if you see any 
artifacts. 


QuadVertexBuffer [boolean] - disables optimization when compiling shader, 
may help to eliminate errors. Try to enable this parameter if you see any 
artifacts. 


EnableShaders_3_0 [boolean] - some effects look better on when rendered on 
shaders 3.0, it is recommended to enable this parameter if your graphics card 
supports shaders 3.0 


AdditionalConfigFile [string] - if following file exists, then EnbSeries will 
automatically load parameter from that file instead of default enbseries.ini. It is 
useful when you are making configurations for other users while your 
enbseries.ini still exists and could be used when additional config file is removed 
or renamed. 


EFFECT 
This section enables or disables effects. More informations below: 


EnableBloom [boolean] - enables or disables bloom effect. Example on images. 


Disabled bloom Enabled bloom 
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Colors of rye and plant are brighter on second picture. 


EnableOcclusion [boolean] - enables screen space ambient occlusions (ssao) 
and screen space indirect lighting (ssil), this makes shadows and lighting 
between nearest objects. This effect is used by few modern games, mostly on 
next-gen game consoles, so it's very slow. Performance directly depends from 
display resolution, number of pixels drawed on screen, so to run this at HD 
resolutions you need modern videocard from high price category. It requires 
support of shaders 3_0, but even if you have it, it's not guarantee fast 
performance. If too slow for you, reduce display resolution and quality of this 
effect, even disable it. Hardware compatibility is limited, different drivers and 
videocards have problems and limited features that result in artifacts. For 
example antialiasing (multisampling) for HDR textures supported only by 
DirectX10 compatible videocards and enabled antialiasing in game or in video 
drivers panel will produce strange artifacts. 


EnableReflection [boolean] - reflection of vehicles. Developed for GTA San 
Andreasm GTA 3, GTA Vice City, but in some games also works, of course not for 
cars. Performance highly depends from multiple quality setting of this effect and 
number of objects drawed. More reflective objects on screen, slower speed. Real 
time 3d rendering works faster when number of objects is low, but their vertex 
number is high, for example 10 objects with 10 millions of vertices every will 
draw about the same speed as 3000 objects with 3 vertices each, for reflection 
on shaders may be used multiple drawing of the same object. In this case 
performance highly depends from CPU and system memory speed. Per pixel 
lighting in newest versions of ENBSeries may be faster for some videocards. 


See more info for REFLECTION. 


EnableMotionBlur [boolean] - blurring image in fast motion of camera. On 
modern videocard not too much decrease speed, but costly. Current version of 
this effect has many problems, not working in most games, wrong, affect HUD, 
later will it be changed. On some videocards does not work correctly, if you have 
some problems, try to disable. 


EnableWater [boolean] - enables water effects. Depending from it's presets may 
affect speed very much, by itself it's fast, but for deepness factor it needs scene 
depth information. Good way to compencate losts for depth is to use scene depth 
for other effects in parallel (shadows, ssao, dof). Modified water textures or water 
material (object) setting may produce unpredictable results. 
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DepthBias [int][0..1000] - shifts objects when drawing scene depth, offset 
relative to camera viewpoint. For some videocards and drivers, combination of 
ENBSeries presets, may be required to remove flickering and hiding artefacts of 
ambient occlusions. Try to set 100 if something wrong happens. This parameter 
not affect speed. 


EnableDepthOfField [boolean] - enables eye focusing effect. This effect affects 
performance a lot, because it needs scene depth information. Whe used together 
with other effects that also require scene depth, performance is not too much 
affected. 


See more informations for 


ENGINE (to do) 


INPUT 
KeyUseEffect [int][1..255] - decimal key number for activation/deactivation of 
modification, by default F12. 


KeyBloom [int][1..255] - decimal key number for bloom activation/deactivation, 
by default F9. 


KeyReflection [int][1..255] - decimal key number for reflection 
activation/deactivation, by default F11. 


KeyCombination [int][1..255] - decimal number of additional key for combining 
this key with others, by default SHIFT. 


KeyScreenshot [int][1..255] - decimal key number for capturing screenshots, by 
default PRINTSCREEN. Images stored in the same folder where ENBSeries, but not 
always, depending from game. Files have BMP format, 32 bit with alpha channel 
(not all image viewers support this). 


KeyShadow [int][1..255] - decimal key number for shadow 
activation/deactivation, by default F8. 


KeyWater [int][1..255] - decimal key number for water activation/deactivation, 
by default F7. 


KeyShowFPS [int][1..255] - decimal key number activation/deactivation 
performance statistic displayed on screen, by default * (multiply). 


See table of 


Page 53 of 186 


Page 54 of 186 


Page 55 of 186 


Page 56 of 186 


Page 57 of 186 


Page 58 of 186 


A game sequence of working. 


REFLECTION 
Short note: reflection applies only to vehicles and it is not effect that drops down 
the performance a lot. 


ReflectionPower [int] [0...5] - Regulates power - brightness of reflections. 


ReflectionPower=12 ReflectionPower=50 


ChromePower [int][0.100] - temporary disabled. Level of steel vehicle parts 
reflection. 


UseCurrentFrameReflection [boolean] - when 1 use for reflection current 
screen image, this reduce quality because not all objects reflected, but there is 
no delay between scene and reflections. Otherwise use previous frame image. 
Performance is much faster when this parameter is active. In GTA San Andreas 
game reflection level depending a bit from this parameter, so after changing it 
correct ReflectionPower also. 


UseCurrentFrameReflection = 0 


Previous frame is used. 


Page 59 of 186 


UseCurrentFrameReflection = 1 


Current frame is used. 


ReflectionQuality [int] [0..2] - quality, 0 means maximal quality and slowest 
speed. At 0 quality reflections not very sharp because they use mipmapping. 
Currently this parameter not affect speed too much, but in future the difference 
will be huge. 


ReflectionQuality = 0 
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ReflectionSourceSpecular [int][0..100] - percent of using "specular" material 
color as reflection factor ("glosiness" in exporter). Some car parts may be 
reflective with this setting, but works good for original car models, set this to 0 to 
elliminate some invalid reflections, but better modify car. This parameter mixing 
with ReflectionSourceTFactor to compute final reflection level. 


ReflectionSourceTFactor [int][0..100] - percent of using "texture factor" as 
game environment map mix level ("reflection" in exporter). Some car parts may 
not be reflective with this parameter and on the contrary, tested and work 
perfectly on original cars. This parameter mixing with ReflectionSourceSpecular 
to compute final reflection level. 


UseAdditiveReflection [boolean] - reflections added to screen car colors 
making bright, in some situations oversaturated reflections. 0 means more softly 
reflection that depends from car brightness, for bright cars reflection level is 
lower than for dark cars. Does not affect rendering speed. 


Disabled additive reflection 
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ReflectionDepthBias [int][0..1000] - shifts reflection geometry relative to 
camera viewpoint. For some videocards may be useful to remove flickering and 
hiding artifacts. ATI videocards users must set this parameter to 100 or 
something like that, unless they use single pass reflections. 


UseLowResReflection [boolean] - use small and blurred texture as reflection, 
looks like matte reflection, interesting effect. By rendering speed it's a bit faster, 
but not too much. 


Disabled Enabled 
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ReflectionSinglePass [boolean] - draw reflection together with car geometry. At 
this moment also activates per pixel lighting, which increase vertex processing 
performance, but decrease it for pixel processing, so it depending from the size 
of car on screen. Temporary some limitations have place, shaders 3_0 required 
and environment texture that simulate reflections not in use. If you have artifacts 
on cars, try to disable this. 


Disabled Enabled 


When it is enabled and graphics card does not support Pixel Shaders 3.0, you will 
enjoy following artifacts: 
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UseEnvBump [boolean] - allow deformation of reflections by car texture, 
brighter texels means more deformed (frequently named environment bump, 
dudv bump). Affect rendering speed, but not too much for modern hardware. 


Disabled - see the difference on glass Enabled - see the difference 
on glass 


EnvBumpAmount [int][0..1000] - level of reflections deformation. Do not set too 
big values, if the car was not specially designed to be compatible with 
environmental bump effect. 
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EnvBumpOffset [int][0..1000] - step for generating direction and amount of 
bump from car texture. Bigger texture size need less value to make visible small 
details. 


Disabled Enabled 


BLOOM 
BloomPowerDay [int][0..100] - intensity of bloom at day time, dependent from 
screen brightness. 


BloomPowerDay = 7 BloomPowerDay = 30 


BloomFadeTime [int][0.. 100000] - time of bloom adaptation to screen 
brightness change, in milliseconds. Not recommended too high values, because 
hard to see changes in time, low values like 100 also bad idea, screen will flash 
frequently, very irritates. 


BloomQuality [int][0..2] - bloom effect quality, 0 means maximal quality. 
Starting from version 0.074 speed does not much depends from this parameter, 
so set 0 all the time. 


BloomQuality=0 BloomQuality=2 
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BloomScreenLevelDay [int][0..100] - level of screen brightness in percents, 
that determined as day time. 


BloomScreenLevelDay=30 BloomScreenLevelDay=60 


BloomCurveDay [int][-10..10] - gamma correction of bloom at day time. 
negative values increases halftone brightness (Smoggy look), positive values 
decrease halftones brightness (contrast, intensive image). 


BloomPowerNight [int][0..100] - power of bloom at night time, dependent from 
screen brightness. 


BloomConstantNight [int][0..100] power of bloom at night time, independent 
from adaptation time between screen brightness change. 


BloomCurveNight [int][-10..10] - power of bloom at night time, independent 
from adaptation time between screen brightness change. 


BloomScreenLevelNight [int][0..100] - level of screen brightness in percents, 
determined as night time. 
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BloomAdaptationScreenLevel [int][0..100] - level of screen brightness in 
percents, over which bloom deactivating. It's desirable that this parameter will be 
greater than BloomScreenLevelDay. 


SSAO (to do) 

UseFilter [boolean] - enable filtering of ambient occlusion texture, currently 
forced to be on if occlusions enabled. Ambient occlusion and indirect lighting 
effect use randomization for sampling textures and this produce noise. Filtering is 
expensive algorithm, it depends from display resolution (any filtering depends 
from resolution actually), so this is the one reason of slow performance, try to 
change it quality. 


COLORCORRECTION (to do) 


WATER 

UseWaterDeep [boolean] - use smooth transition between different water deep 
levels, low deep is transparent water, deep water has color of water object. As 
effect itself not too high decrease speed, but it need for computation scene depth 
information that computes really slow, if you don't use any effects that require 
scene depth (ambient occlusion, depth of field, shadow quality 0 or 2), then 
disabling this will increase performance greatly. Otherwise, if scene depth 
already used, activating this parameter is almost for free (see performance tips). 
When this parameter deactivated, water is clear and only refraction visible (at 
this time). 


Disabled 
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Enabled 


WaterDeepness [int][0..1000] - factor of water semitransparencity at difference 
deep levels. Not affect rendering speed. 


WaterDeepness = O WaterDeepness = 200 


WaterQuality - quality of water effects, 0 means maximal quality. Currently 
almost no difference in performance from changing this parameter, but later 
things will be changed. 


SHADOW 

ShadowFadeStart [int][0..1000] - distance, at which shadow starts to be less 
intensive. It must be less or equal to value of ShadowFadeEnd, if distance to 
shadow is less than this parameter, shadow color do not change. In GTA San 
Andreas shadows appears/dissapears instantly, this parameter fix this problem. 
In fact, shadows still have the same behavior as before, but their transparency 
changes. This parameter ignored if ShadowQuality set to 2, because it need 
scene depth information. No speed affect from this parameter. 
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ShadowFadeEnd [int][0..1000] - distance at which shadow dissapear 
completely. It must be greater or equal to value of ShadowFadeStart, if distance 
to shadow is greater than this parameter, shadow is invisible. Other description is 
the same as for ShadowFadeStart. 


ShadowAmountDay [int][0..100] - percent of shadows intencity in the day. Day 
time computes by reading brightness of rendered screen and set by 
ShadowScreenLevelDay parameter. If value is 0 then shadow is not visible, if 
value is 100, it's opaque and dark. 


ShadowAmountNight [int][0..100] - percent of shadows intencity in the night. 
Night time computes by reading brightness of rendered screen and set by 
ShadowScreenLevelNight parameter. If value is 0 then shadow is not visible, if 
value is 100, it's opaque and dark. 


ShadowScreenLevelDay [int][0..100] - level of screen brightness in percents, 
that determined as day time. It's easy to compute brightness in any image 
editing software by blurring game screenshots. For example, Adobe Photoshop in 
filters have Blur->Average, it produce RGB color of screen brightness, now 
choose one from R, G, B components that have highest value (info panel, minimal 
0, maximal 255 for 8 bit per channel images), divide it by 256 and multiply by 
100, result will be screen brightness in percents. If screen brightness in the game 
higher than this parameter, it will be day time any way, for lower value, all 
brightness dependent parameters will be interpolated between night and day 
presets. 


ShadowScreenLevelNight [int][0..100] - level of screen brightness in percents, 
that determined as night time. Description is the same as for 
ShadowScreenLevelDay parameter. 


ShadowQuality [int][0..2] - quality of shadows, 0 is maximal, distance from 
camera to shadow and vector of shadowed surface normal affects shadow 
blurring. At quality 1 surface normal ignored. At quality 2 everything ignored and 
blurring radious is constant on screen. This parameter affect performance, 
because quality setting 0 and 1 use scene depth information. For old videocards, 
integrated videochips and videocards with 64 bit videomemory bandwidth better 
to set this parameter to 2. Exception is only if scene depth information is used in 
some other effect already (ambient occlusion, water deep, depth of field). 


UseShadowFilter [boolean] - enable filtering of shadows. Currently for blurring 
shadows i use randomizing, this produce a lot of noise that must to be filtered, 
but filtering eats a lot of speed, especially on old videocards, integrated 
videochips and videocards with 64 bit videomemory bandwidth. 


FilterQuality [int][0..2] - quality of shadows filtering, 0 is maximal and slowest, 
filtering happens in several rendering passes. With quality 2 only one pass used. 
Performance varies from this parameter, be careful, also ShadowQuality affect 
speed of filtering, with quality of shadows 2 filtering works much faster. 
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ShadowBlurRangel[int][0..100] - radius of blurring on the screen, too big values 
produce artifacts. If value is very low, performance may be faster because of 
texture cache. 


ShadowBlurRange = O 


ShadowBlurRange = 50 


ENGINE (to do) 


MOTIONBLUR (to do) 
PERPIXELLIGHTING (to do) 


DEPTHOFFIELD 

Depth of field (DOF) is the distance between the nearest and farthest objects in a 
scene that appear acceptably sharp in an image. A larger DOF gives sharper 
graphics. By contrast a smaller DOF is less GPU intensive and provides more 
contrast between CJ (together with the vehicle, if he is driving one) and the 
surroundings. 


DOF Quality [int][0..2] - quality of depth of field effect. O means maximal quality 
and slow performance. Higher quality makes less noisy look. This parameter 
affects gaming speed and directly depends from display resolution, see 
performance tips section. 


Look on leaves: 
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DOFQuality = 0 


DOFNumberOfPasses [int][1..5] - effect drawing several times, this parameter 
allows to configure how many times. It makes more or less visible blurriness on 
screen. Watch out for performance, each pass computes effect. 


DOFNumberOfPasses = 1 DOFNumberOfPasses = 5 
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DOFFocusRange [int][0..1000] - focusing level as distance factor, less value 
means smaller area where objects still unblurred. 


DOFBlurinessRange [int][0..10] - relative to screen radius of blurring. 
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Vehicles 


Definition 

A vehicle is a device that is designed or used to transport people or cargo. Most 
often vehicles are manufactured, such as bicycles, cars, motorcycles, trains, 
ships, boats, and aircraft.[2] 


Vehicles that do not travel on land often are called craft, such as watercraft, 
sailcraft, aircraft, hovercraft, and spacecraft. 


Land vehicles are classified broadly by what is used to apply steering and drive 
forces against the ground: wheeled, tracked, railed, or skied. ISO 3833- 1977 is 
the standard, also internationally used in legislation, for road vehicles types, 
terms and definitions. 


Vehicles in GTA San Andreas 


Types 
car (0), mtruck(1), quad(2),f_heli(3), heli(3), plane(4), boat(5), train(6), 
f plane(8), bike(9), bmx(10), trailer(11) 


Type and ID in Description 
memory 
car (0) 4 wheels, used for 


standard cars, trucks, 
buses, tractor. 

car type requires one 
general handling line. 


mtruck (1) Monster track behavior - 
wheels have damper and 
can crush the car they 
collide with. Wheels are 
scalled well for model. 

If model of monster truck 
will be used on non- 
mtruck vehicles, then 
wheels will be expanded. 


quad (2) Quad physics - 4 wheels 
bike with engine. 
Requires additional bike 
handling. 


F heli (3) Unused type in standard 
game. The name might 
refer to a fighter, 
although setting this 
type to arbitrary 
helicopter doesn ‘t 
enable shooting. 


heli (3) Helicopter -propeller 
spins around and vehicle 
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can resist in the air 
without flying ahead 
unlike planes. 


plane (4) 


Planes must fly ahead in 
order to resist in the air, 
otherwise it will go down 
and crash on the ground. 


boat (5) 


A boat is a watercraft of 
any size designed to float 
or plane, to provide 
passage across water. 
Boats are declared by 
only 11 arguments inside 
cars section of IDE files. 


train (6) 


This type is used for both 
trains and trams. 


A train is a connected 
series of vehicles for rail 
transport that move 
along a track (permanent 
way) to transport cargo 
or passengers from one 
place to another. 


A tram (also known as a 
tramcar, streetcar, 
trolley car) isa 
passenger rail vehicle 
which runs on tracks 
along public urban 
streets and also 
sometimes on separate 
rights of way. It may also 
run between cities 
and/or towns 
(interurbans, tram-train), 
and/or partially grade 
separated even in the 
cities (light rail). Trams 
very occasionally also 
carry freight. 


f plane (8) 


Unused type in standard 
game. The name might 
refer to a fighter. 


bike (9) 


A motorcycle (also called 
a motorbike, bike, or 
cycle) is a single-track, 
two-wheeled motor 
vehicle. Motorcycles vary 
considerably depending 
on the task for which 
they are designed, such 
as long distance travel, 
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navigating congested 
urban traffic, cruising, 
sport and racing, or off- 
road conditions. 


bmx (10) A bicycle, also known as 
a bike, pushbike or cycle, 
is a human-powered, 
pedal-driven, single-track 
vehicle, having two 
wheels attached to a 
frame, one behind the 
other. 


trailer (11) A trailer is generally an 
unpowered vehicle 
pulled by a powered 
vehicle. Commonly, the 
term trailer refers to 
such vehicles used for 
transport of goods and 
materials. 


Configuring vehicle 


Declaring vehicle in IDE 
A vehicle is one of defined objects in GTA SA, therefore it needs to be declared in 
IDE files. 


Read informations of CARS section to find out a way to do it. 


Vehicle handling - handling.cfg 

The handling.cfg file is a text data file format which sets many performance and 
behavior values for each vehicle in GTA SA. The file can be opened and edited 
with any text editor. 


There are also some tools to permit the user, modification of file in GUI, more 
readably. 


File format 
The handling is text file loaded line by line. 


Lines can be commented by putting a ; (one semicolon) at the beginning of a 
line. Commented line is completely ignored and skipped by internal parser of GTA 
SA. Therefore it is commonly called a "single-line comment." 


Explanation of sections and parameters 


Standard Data 

This section contains all the performance settings for land vehicles and 
provides the base settings for boats, bikes and flying vehicles. The below 
table provides the column letter, column name and a brief description for 
each setting available in this section. 


Page 75 of 186 


Colum 
n 
Letter 


Column Name 


Description 
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Relates this data with IDE entry of 


vehicle identifier : 
vehicle. 


Mass of the vehicle in kilograms. 


Used to calculate motion effects. 
Practically it changes mass acting on 
vehicle when it is turning (left or right) 
and the way how hard it is. Too high 
values will make vehicle able to flip 
around. 


fTurnMass 


Changes resistance to movement, what 


fDragMult 
ei results in maximal speed of vehicle. 


Distance from the centre of the car in 
CentreOfMass.x metres to the right for the centre of 
mass. 


Distance from the centre of the car in 


ntreOfM ; 
SEMIS OMT) metres forwards for the centre of mass. 


Distance from the centre of the car in 


CentreOfMass.z 
metres upwards for the centre of mass. 


Percentage of the vehicle height 
nPercentSubmerged required to be submerged for the car to 
float. 


Cornering grip of the vehicle as a 
multiplier of the tyre surface friction. 


fTractionMultiplier 


Accelerating/braking grip of the vehicle 
fTractionLoss as a multiplier of the tyre surface 
friction. 
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fTractionBias 


Ratio of front axle grip to rear axle grip; 
higher value shifts grip forwards. 


TransmissionData.nNumberOf 
Gears 


Number of gearchange animations and 
sound effects to use. 


TransmissionData.fMaxVelocit 
y 


TransmissionData.fEngineAcce 
leration 


TransmissionData.fEnginelnert 
ia 


Limits the top speed. 


Basic rate of acceleration. 


Smooths or sharpens the acceleration 
curve. 


TransmissionData.nDriveType 


TransmissionData.nEngineTyp 
e 


fBrakeDeceleration 


Assigns Front, Rear or 4 wheel drive. 


Assigns Petrol, Diesel or Electric engine 
characteristics. 


Overall decelerative force. 


fBrakeBias 


Ratio of braking force of front compared 
to rear; higher values move bias 
forward. 


fSteeringLock 


ABS Brakes "0" = no and "1" = yes 


Maximum angle of steering in degrees. 


fSuspensionForceLevel 
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fSuspensionDampingLevel 


Stiffens the dampening strength as 
speed increases. 


fSuspensionHighSpdComDamp 


suspension upper limit Explained in my suspension tutorial. 


suspension lower limit Explained in my suspension tutorial. 


suspension bias between front | Ratio of suspension force to apply at the 
and rear front compared to the rear. 


Changes the amount of body pitching 
under braking and acceleration. 


suspension anti-dive multiplier 


Distance from door position to seat 
position. 


fSeatOffsetDistance 


Amount of engine damage vehicle gets 
from collisions. Higher value means 
more damage. 


fCollisionDamageMultiplier 


Used to calculate the Value of property 
damaged statistic. 


af modelFlags Special animations features of the which 
7 can be enabled or disabled. 


handlingFlags 


nMonetaryValue 


Special performance features. 


ah front lights Type of head lights of the vehicle. 
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al rear lights Same as above but for the tail lights. 


aj Vehicle anim group Refers to an Animation ID number. 


Sound properties - VehicleAudioSettings.cfg 

Almost every vehicle should have sound; otherwise we would have a silent 
streets. In order to configure sound properties of vehicles we could use Vehicle 
Audio Loader created by fastman92, author of the book. 


vehicleAudioSettings.cfg is text file, being processed line by line. Empty lines or 
lines commented by a; sign at the beggining are ignored and skipped by the 
function readVehiclesAudioSettings which parses a file. 


Parameters are delimited by white characters such as space or tabulator. Types 
of values are reserved and float 1.0 shouldnt be modified to an integer 1 


Model names work for any vehicle defined inside of IDE file. 
The table presents the meaning of values in line according to their position. 


Line parameters 


Column comme Type Description 
Letter Name YE P 
A model name of vehicle which is defined inside 
modelName |string |of aIDE file. No matter if is standard or added 
vehicle. 
VehicleType |__intl16 |Vehicle type, see table below. 
edi __int16 |Sound bank ID of accelerative, inhibitory engine. 


EngineOffSo 
und 


Sound bank ID of stopped vehicle with enabled 
engine. 


of le 


__int1l6 
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field_4 __intl6 |Unknown __int16. Used values by R*: 0, 1, 2 
field_6 float Unknown float. 


HornTon sos Not tested by the creator of plugin 
HornHigh float Not tested by the creator of plugin 


DoorSound ee Not tested by the creator of plugin 


ID of default radio station being enabled when 
player enter a vehicle. Index of station is 
starting from 1. 

RadioNum char : : ; 
Click here to see the List of radio stations. 
If RadioType != 0 (civilian radio), RadioNum 
should equal to 13 (radio off) 


signed |Type of radio (-1 = no radio, 0 = civilian, 1 = 
RadioType : ; 
char special, 2 = may not exist, 3 = emergency) 


field 14 signed Unknown. 
= char 


field_16 float Unknown float 


TT TT Ty 
ely b Una eye 


2 


RadioNum 
This parameter determines a default radio automatically turned on when player 
enters a vehicle. Index of radio station is starting from 1. 


Click here to see the List of radio stations. 


Example 


Landstal 0 99 98 | 
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0 0.779999971389771.0 Fi 


0 0 0.0 


Binary file specifications 


IMG archive (.img) 
IMG archives contain the game files (map items), usually: 


DFF models 

TXD texture archives 

COL collision sets 

IPL binary map files 

IFP animations for peds or objects 
CUT cutscene text data 

DAT cutscene camera movements 


Seu 


There are hardcoded IMG archives to be loaded by GTA San Andreas and 
additional defined in basic map files. 


List of hardcoded IMG files can be found in hardcoded img files table on page 20 
and description on how to define additional IMG archives in basic map file to be 
loaded on page 43. 


IMG archives have relatively simple format and be divided into 3 parts. 
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Header 

Offset Type Value 

0x0 CHAR[ 4] “VER2” always 

0x4 DWORD Number of files on list (n) 


File list 

Starts on offset: 0x8 

Each entry description takes: 32 bytes. 
Entry description: 


Offset Type Value 

+0x0 DWORD File offset, in blocks (file offset / 2048) 
+0x4 WORD Size, second priority in blocks (file size / 
2048) 


+0x6 WORD Size, first priority in blocks (file size / 
2048) 
+0x8 CHAR[24] File name NULL (0x00) terminated. 


If +6 SizeFirstPriority is NOT zero, +6 will be used as file size, 
else +4 SizeSecondPriority will be used. 

It’s been unnoticed for 7 years because all standard R* IMG 
archives have +6 with zero value applied to all entries. 

Zero didn't change resulting value read by IMG editors when treated 
as DWORD. 


File contents 

File contents are right after a file list. They are aligned to 2048 
bytes boundaries. It means position of file in IMG archive must be 
divisihle hv 2048. Therefore file in samnle archive can he stored 


Though the file offset and size is divided by 2048 and theoretical maximum size 
of IMG archive is FILE OFFSET OxFFFFFFFF * 2048 bytes; OXffffffff bytes = 4 GB - 
1 byte; 4 GB * 2048 = 8192; the maximum size of IMG archive is 4 GB, because 
GTA San Andreas works on 4-byte integer while it multiplies by 2048 to get 
position of file in IMG archive and read the file. 
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Programs 


Programs can operate on IMG archives. Good programs can remove or replace 
files from IMG archives without need to rebuild whole archive. They can add file, 
truncate IMG archive, then calculate new offsets on file list and replace them. 
Powerful IMG editors let the user to directly view TXD textures without need to 
extract them and unpack in external program. Programs are described in 
alphabetical order. 


Alci s IMG Editor 
It is IMG editor using QT GUI. Supports mostly needed operations and performs 
them quickly. The author is Alci. 


" @ Alci’s IMG Editor 1.5 - gta3.img — i 
File | Actions | Info 
> Import Ctri+ Shift+1 rl go 
> Import (remove if exists Ctrt+l I 
-.. % Export Ctri+E | ante _ 
| | jt %, Export as list CtrleL 22KB 
cj_st OY} Delete Del 256 KB 
wate © Reload F5 18 KB 
von EP Rebuild Ctri+R 258 KB 
asl Find next F3 834K8 
Compare Ctri+P 
bodice regeuser om 170 KB 
| ballyswater. ted TxD file 258 KB 
| |e51_detaistuff.txd TxD File 926 KB 
851_siphe.txd TxD file 538 *B 
Advantages: 
Y Creating new IMG archive 
Y¥ Searching files 
¥ Adding files 
v Replacing files 
Y Deleting files 
vy Exporting files 
¥ Rebuilding archive 
¥ Bulk replace 
v Exporting file list as text file in format (filename, newline, filename, 


newline, filename) 


¥ Comparing IMG file list against previously exported file list 
Y No changes are applied to IMG archive until Save option is selected. 
Disadvantages: 


e No altering the name of files 
e Need to rebuild archive. 
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¢ Doesn*t support IMG archives above 2 GB. 
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Crazy IMG Editor 
It has some unique feature like adding with replacement and extracting old files. 
The author is CrazyVirus. 


Mg. GTA: SA Crazy IMG Editor v1.0 Final - [gta3.img]y ye (2) (| El 
File te 


+@A Find... Ctrl+F 
4 Find next F3 
dito Find all with... 


com Find identical 


SO) off" Extract Ctrl+E 
lt “| ep Add.. Ins 
oLb Add with replacement... Ctrl+Ins 
on Add with replacement and extract existing...  Shift+Ctrl+Ins 
sail Delete Del 
bride “fh Replace... Ctrl+R 
boxk = Rename Ctrl+N 
bistr 
| bistr Copy name(s) to clipboard Ctrl+C 
_ bistrobar.dff 
1 bag_belt2.dff 
| alpha_fence. dff 
airport_int2. dff 00392800 
airport_front. dff 0034F800 
Archive is opened 
Advantages: 
¥ Searching files 
¥ Adding files 
v¥ Replacing files 
vY Deleting files 
v¥ Exporting files 
Y Rebuilding archive 
Y Find identical files (by names) 
Y Bulk replace 
v Select files with type (e.g dff files only) 
v Invert selection 
v Save the list of files 
v Find all with part of name 


Disadvantages: 


e Every change is already saved to file, can’t save changes to IMG file by 
pressing “Save” 
e Need to rebuild archive. 
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G-IMG 
Another powerful IMG editor. The author is RESpawn. 


Requires .NET Framework 2.0 installed. On Vista or Seven it requires to apply this 
fix in order to run: 


%Swindirs\Microsoft.NET\Framework64\v2.0.50727\ldr64.exe setwow 


eg ed ety eet ma gc gee a ga a ge a a png pe pa fg pt ye et ee pe Se a ee eres, Se Se SS ee 


bt a a 


Commands | Tools Options 


Quick Extract FS 
Delete Del 


View 


Replace F3 
Move ToEnd F4 


Flagged Files 
Rebuild 


@ perechuteifp 
@ vegtrefic2nd 
@ mitvafticted 
© geyarefited 
© ¢j_tefficted 
@ cj _street_props.ted Decth Sine 

@ woterfall_ twit 7 tee 128 128 
@ vgndentan3.td 


@ vegaswatertallted 


@ a51_detailtutt. od 
@ O5l_siphated 


HB San Andreas Flee: 15664 


Advantages: 


Creating new IMG archive 
Searching files 

Adding files 

Replacing files 

Renaming files 

Deleting files 

Exporting files 

Integrated texture viewer 
IDE Harvest 

Merging IMG archives 
Rebuilding archive 

Click double on file to open it extracted in default program 
Bulk replacement 


LLL LKR LRA 


Disadvantages: 


e Every change is already saved to file, can’t save changes to IMG file by 
pressing “Save” 
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e Need to rebuild archive. 
¢ Doesnt support IMG archives above 2 GB. 
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IMG Manager 
The greatest feature that makes this tool innovative is it supports archives over 2 
GB up to 4 GB (IMG max size). The author is Xmen. 


Requires .NET Framework 2.0 installed. On Vista or Seven it requires to apply this 
fix in order to run: 


%Swindirs\Microsoft.NET\Framework64\v2.0.50727\ldr64.exe setwow 


it el ti ne Ym met mat mm ma mre mm gg ah yr ea a a ay etal yh i ah gt a a emt i 


__gIMG Manager eee 
| File Edit Help 
Name Offset Size = 
veatrafic2 ted 36454400 12 KB First offset/size 3471360/268 
ae 36504032 112 KB Last offset/size 1574660096/370 
gay_xref txd 125966336 | 256 KB 
oj_traffic ted 519735296 22 KB 
j_street_props txd 126826496 256 KB 
waterfall_sfw txd 87615488 | 18KB 
vgndwntwn3 txd 1223315456 | 258 KB 
vegaswaterfall td 360171520 10 KB 92815 file(s) can be add before auto rebuild 
rezero_track txd 1018521600 | 834 KB 0152 _useless space (in MB) 
lodcunty txd 187158528 | 170 KB 1502 IMG size (in MB) 
ballyswater txd 212365312 | 258 KB 4095 Max IMG Size (in MB) 
a51_detailstuff ted 545693696 926 KB = 
ail shdmind 242333696 _|538 KB B Ado Update =O vec 148 me 
D:\Projects\GTA Speed\models\gta3.img 1/15664 
Advantages: 
Y Creating new IMG archive 
¥ Searching files 
Y Adding files 
v¥ Replacing files 
¥ Renaming files 
Y Deleting files 
v¥ Exporting files 
¥ Supports IMG archives up to 4 GB size 
¥Y No need to rebuild an archive after adding file 
¥Y No need to rebuild archive 
¥ Rebuilding archive 
¥ Configure programs to open for COL, DFF, IFP, IPL, TXD, click double, 


close program and question to save updated file. 

Bulk replacement 

Drag and drop method is possible. No need to waste time on selection 
of folder.You can drag and drop files from explorer to Spark file list and 
file will be imported. Exporting by dragging and dropping is also 
possible for files up to 25 MB. 

¥ Integrated binary IPL viewer 


SAN 


Disadvantages: 
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e Every change is already saved to file, can’t save changes to IMG file by 
pressing “Save” 


IMG Tool 
It was the first working tool created for GTA San Andreas to open and edit IMG 
archives. The author is Spooky. 


rr ————— 
IMG Tool 2.0 - gta3.img - GTAGarage.com 


File Edit Commands Tools Help 
File Name Offset Size 


ci_street_props.txd O78F3800 256 kb 
waterfall sfw.txd 0538E 800 18 kb 
y¥ondwntwn3_txd 48E45000 
Extract 15770800 10kb 
3CB56800 834 kb 
0B27D000 170 kb 
OCA487000 258 kb 
20864000 926kb | | 
OE71B800 538 kb 


Replace 


Delete 


Rename 


Version 2 Archive loaded. 15664 files (1) 


Advantages: 


v 
v 
v 
v 
v 
v 
v 
v 


Rebuilding archive 
Searching files 
Adding files 
Replacing files 
Extracting files 
Deleting files 
Renaming files 
Exporting files 


Disadvantages: 


e Every change is already saved to file, can’t save changes to IMG file by 
pressing “Save” 

¢ Doesnt support IMG archives above 2 GB. 

e Need to rebuild archive. 

e No bulk replacing 

e No more possibilities. 
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Spark IMG Editor 

It is editor with a lot of features. One disadvantage is it can’t rebuild archive and 

can t add files without need to rebuild. Program requires .NET framework 2.0 
The author is Arushan (aru) 


peshi9.txd 


3!) VosN_nitree_b01.dff 
33) VosN_nitree_r01.dff 
3!) VgsN_nitree_y01 df 
|) ota_tree _ palm ted 
|] ota_tree_bevhills ted 
|] gta _Procdesert txd 
|) ota _Potplantsaa txd 
|] ota_deserttrees txd 
|i) tree3.ted 
|i) tree3pre.txd 
|) ota_tree_pine txd 56a231d2 
|i] gta_tree_oldpine txd {a 

‘| |i) gtatreeshi9. xd = 
<@ , 


Advantages: 


¥ Creating new empty IMG archive 

¥ Searching files 

v A4views of file list like in explorer (Explorer, Icons, List, Details) 

v¥ Drag and drop method is possible. No need to waste time on selection 
of folder.You can drag and drop files from explorer to Spark file list and 
file will be imported. Exporting by dragging and dropping is also 
possible for files up to 25 MB. 

Adding files 

Replacing files 

Renaming files 

Deleting files 

Exporting files 

Bulk replacement 

Sort files by name, type, offset or size. 

Integrated texture viewer 

No changes are applied to IMG archive until Save option is selected. 


OO OOS 


Disadvantages: 


Page 91 of 186 


¢ Need to rebuild archive. 
¢ Does not support archives above 2 GB archives while 4 GB is max IMG 
archive size. 
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SCM compiled script 


SCM files store missions and several other scripts. 


.scm file needs special structure, 


have an exact code only. 


Compiled code - opcodes 


while plain scripts, often with .cs extension, 


An opcode- the smallest operation that could be executed in SCM script, 


including math 


Compiled code - data types 


Data types (in hex) Size of Extra info 
data 
Static numbers 
Ol 4 Static number: (Long) Integer - 32 bits 
02 2 Global 4-byte integer /float variable 
multiplied by 4: (Short) Integer - 16 bits 
03 Z Local variable: (Short) Integer - 16 bits 
04 i Static number: (Char) Integer - 8 bits 
05 Zz Static number: (Short) Integer - 16 bits 
06 4 Float IEEE 754 - 32 bits 
Number arrays 
07 6 Global Array 4-byte integer /float Var: 
Primary Global variable ID multiplied by 
4 (2 bytes): (Short) Integer - 16 bits 
and left 4 bytes, Compiled code - array, 
data next after primary variable 
08 6 Local Array 4-byte integer /float Var: 
Primary Local variable ID (2 bytes); 
and left 4 bytes, Compiled code - array, 
data next after primary variable 
Short and varlength strings 
09 8 (Short) string - 8 bytes 
OA Zz Global 8-byte short string variable 
multiplied by 4: (Short) Integer - 16 bits 
OB Z Local 8-byte short string variable: (Short) 
Integer - 16 bits 
OC 6 Global Array 8-byte short string Var: 
Primary Global variable ID multiplied by 
4 (2 bytes): (Short) Integer - 16 bits 
and left 4 bytes, Compiled code - array, 
data next after primary variable 
OD 6 Local Array 8-byte short string Var: 
Primary Local variable ID (2 bytes): 
(Short) Integer - 16 bits 
and left 4 bytes, Compiled code - array, 
data next after primary variable 
(Oje ee Varlength string: 
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string.lengt | 1** byte gives the length of exact string; 
AQ) therefore maximal length is 255 
characters. 

String doesn t have to be NULL 
terminated, because length is known. 


OF 16 (Short) string - 16 bytes 
Long strings 
10 2 Global 16-byte long string variable 
multiplied by 4: (Short) Integer - 16 bits 
11 2 Local 16-byte long string variable: 
(Short) Integer - 16 bits 
12 6 Global Array 8-byte long string Var: 


Primary Global variable ID multiplied by 
4 (2 bytes): (Short) Integer - 16 bits 
and left 4 bytes, Compiled code - array, 
data next after primary variable 


13 6 Local Array 8-byte long string Var: 


Primary Local variable ID (2 bytes): 
(Short) Integer - 16 bits 

and left 4 bytes, Compiled code - array, 
data next after primary variable 


Compiled code - array, data next after primary variable 
Secondary Variable, index to take and add value from (2 bytes), 


Size of an array (byte), amount of indexes, 
Type of variable and multiplier for index to add (byte) , 
Value from secondary variable is multiplied by 4 if type is global variable. 


Compiled code - array, type of multiplier and multiplier for index from 
secondary variable 
0x00 - local variable, multiply value * 1 vars - integer arrays 


OxO1 - local variable, multiply value *1 vars - float arrays 
0x02 - local variable, multiply value * 2 vars -short string arrays 


0x03 - local variable, multiply value * 4 vars -long string arrays 


0x80 - global variable, multiply value * 1 vars - integer arrays 
Ox81 - global variable, multiply value * 1 vars - float arrays 
0x82 - global variable, multiply value * 2 vars - short string arrays 


0x83 - global variable, multiply * 4 vars - long string arrays 
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Compiled code - array example 
Example in SB: 


$5($4,42i1)- 071400 10 00 2A 80 
07 -initialize data type: Global Array 4-byte integer /float Var 
14 00 - primary global variable multiplied by 4, 0x14/4 =$5 


10 00 - secondary, global variable to take value from and add to primary 
variable, multiplied by 4, 0x14/4 =5 


2A - size of $5 array (Ox2A = 42) in amount of variables 


80 - according to 


Error: Reference source not found, 0x80 identifies secondary variable as global 
and multiplies * 1. 


Audio 


Radio 


List of radio stations 


Radio ID, starting Radiomame 
from 1 
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Bounce FM 


SF-UR, San Fierro 
Underground Radio 


Radio Los Santos 


Radio X 


K-JAH West 


Master Sounds 98.3 


WCTR, West Coast Talk Radio 


User tracks 


ae Se 
a 
a 
TS 
ae 3299 coneno 
aa 
— 
pk 


Information 


How the process in memory works. 


Every running application (process) occupies memory where are stored 
temporarily generated data. .exe file goes to memory too. Good examples of 
temporarily generated data are loaded models, assigned tasks, created actor & 


vehicle, object handles and so forth. 


Every different EXE has different memory addresses so that gta_sa.exe 1.0 


addresses don’t match to gta_sa.exe 1.01. 
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Compiled application has compiled CPU instructions called Assembler (ASM 
shortly). EXE file content could be divided into following parts: 


e ASM code - it is executed by processor. Fully loaded to memory. 

e Used data - they are in EXE and are loaded to memory, but aren’t 
processor instructions; instead they can be processed as values (get to 
CPU register) during execution of ASM code. 

e Resources - they are in EXE, but need to be loaded through ASM to 
memory. Therefore it is possible to have EXE installers of enormous size 
and data go to memory only by request. 


Beginning of Windows executable is stored in memory on address: 0x400000 


However ASM code and values in memory are divided to allocated segments. For 
this part of EXE they are static so that their address is not dynamic and different 
during each execution of game. 


EXE content is read/write protected in memory. 


e Generated data - they are only in memory and are generated by ASM code 
based on files, calculations and so on. It is more complex than two 
sentences. 


Read/Write protected (virtual protect) - it is important to know if address to 
modify is read/write protected. If it is, then it cannot be directly modified, since it 
needs to have a protection removed. There is available VirtualProtect function in 
programming languages and could be used while making trainers or ASI plugins 
which change the memory. CLEO opcodes reading memory can handle 
virtual_protect too. 


Hex editors 

Hex Editor with ability to open and edit process is necessary to gain deeper 
understanding of how memory works. Hex Editor Neo is recommended which is 
payable, but it is worth all spent coins. 


Another hex process editor is HxD. Main disadvantage is disability to analyze 
data types directly in hex editor what makes analyzing values harder. In memory 
there is no type of data set up, but what is meaning of value on address depends 
on how this value will be treated by ASM code. It might be confusing as hell 
however there could be specified types of data in memory. 


Cheat Engine is memory editor and disassembler. When address is known it can 
find out what address containing ASM code is reading/writing to this address. 


NOP Operation: 
NOP - No operation in ASM. It’s single code is 0x90 


Usually it is necessary to replace some ASM code with 0x90 to prevent 
something, for example if address is found out and it is not necessarily 
overwritten. Then Cheat Engine can be used to find out what writes to this 
address and can show how many bytes this ASM instruction have. 
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Value types 


Names| Description | Size Range 
false value. FALSE 
integer. 
word, int Short integer, 2 bytes = 16 bits 
word is always 32767 
unsigned. unsigned: 0 to 


dword, longword, | Short signed 4 bytes = 32 bits | signed: 
int integer. Dword is —2147483648 to 
always unsigned. 2147483647 
unsigned: 0 to 
4294967295 


float Single precision 4 bytes = 32 bits | to (2—2-—23) x 
floating-point 2127 = 3.4 x 1038 
format 

string, text String is a finite Length is Length is 
sequence of determined by determined by 
symbols that are NULL (0x00) NULL (0x00) which 
chosen from a set | which terminates | terminates string 
or alphabet. It is string 
NULL (0x00) 
terminated. 


Finding & patching memory addresses 

Instruction of finding addresses is designed for beginners. IDA Disassembler and 
solid ASM knowledge is needed for analyzing complex EXE. Cheat Engine is used 
to find these addresses in tutorials. Example below is performed on GTA San 
Andreas HOOLDRUM No-CD 1.0 US 


As always the most trivial example in finding memory addresses is searching for 
money address. First make sure you have a big number of money, because it is 
not often in memory to have many the same multibyte values. 
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See in game what is number of your money shown on HUD. It is 14525678 in 
example. Memorize it and minimize game. 


Open Cheat Engine, open process named gta_sa.exe. Type a money value in field 


Cheat Engine 6.0 


File Edit Process Help 
O0000874-gta_sa.exe 


} Address FirstScan | | Next Scan Undo scan 


Value: 
Hex 14525678 


Settings 


Scan type | Exact Value 


Value type | 4 Bytes 


Memory Scan Options 
Start 90000000000000000 


Stop NELTECLESECLLEECE 


[| Unrandomizer 
|] Enable Speedhack 


| Also scan read-only memory 

® Alignment 
~) Last digits 
| Pause the game while scanning 


\V| Fast scan 4 


Ds) 
Memory view Q| 


Active Description Address Value 


| Advanced options Table Extras 


Now problem needs to be considered what is Value type. It is known that money 
in GTA San Andreas don't have fraction and do not look like this: 4.5; there is $4. 


Float and double drops out because they are for fractional numbers. 


Text - it is just string NULL (0x00) terminated. Money won't be text value in 
memory as they are processed for calculations. 
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Now it is known it must be integer value. 1-byte, 2-byte or 4-byte. It tells about 
max number of value. 


You need to recognize what is highest number of money in GTA San Andreas. It is 
999 999 999. 


Check what type of value can store value of this size or higher by finding it on the 
table Value types, above. 


It is 4-byte integer obviously, because only 4-byte int can store numbers of 
minimum value 999 999 999. 


Click First scan in Cheat Engine. 


(e Cheat Engine 6.0 se. se + _s e. 


File Edit Process Help 


00002488-gta_sa.exe 


Address Value | New Scan | | Next Scan : 

Settings 
OOB7CESO 14525678 Value: 
OOB7CES4 14525678 | |}Hex 14525678 


OOBAA430 14525678 


Scan type Exact Value 


Value type 4 Bytes 


Memory Scan Options 


(} Unrandomizer 
Enable Speedhack 


7LELLCLLCCCCCCCCCCC 


Also scan read-only memory 

9) Alignment 
Last digits 

Pause the game while scanning 


Fast scan | 4 


ty 


Active Description Address Type Value 


Advanced options Table Extras 


3 values have been found. Click right red arrow to add them to the list. Now you 
can change one by one to check what modifies money. 
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= Cheat Engine 6.0 l=] o 8 8 


File Edit Process Help 


} Q0002C08-gta_sa.exe | 
Address Value sab on 


0O0B7CESO 14525678 WEP Settings 
OOB7CES4 14525678 M]Hex 14525678 
OOBAA430 14525678 


Scan type | Exact Value 7| 


Value type 4 Bytes 


Memory Scan Options 
= Change Value 


what value to change this to? 


Memory view 


Active Description Address 
No description OOB7CE50 


L] = No description OOB7CE54 4 Bytes 14525678 
No description 00644430 4 Bytes 14525678 


Advanced options Table Extras 


Click first address value, modify and OK. Go to game. Check what happens. 


Yes. That's it. Money started to count down to given value. Now what's in second 
address? 


Modify it to e.g. 0 value. Go to game. GTA San Andreas counts down this value to 
value from the first address. 


So that in 1.0: 
First address (OxB7CE50O) - current money 


Second address (OxB7CE54) - money displayed on HUD, it is going to value from 
the first address. 


Assembler short tips 
xor eax, eax — reset eax, set register to 0 (zero) 


and eax, OFFh — extract only first byte from eax register. Set 2nd, 
3rd byte, 4th byte to zero. 


Example: 
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11010101 §00010100 § 10111010 10101103 


AND 


00000000 } 00000000 | 00000000 
RESULT: 


OO0000000 F OOO00000 F OO000000 F 10101107 


Function addresses 
GTASA_CRC32_FromString (char* String) 


0x0053cf00 - exe 1.0 
0053D3A0 — exe 1.01 
00438500 — init cheat 
Memory values 


Uncategorized 
Identify gta_sa.exe version in memory, the first byte with different value in all of 
mentioned versions: 

Description: Memory address to identify gta_sa.exe version 


In 1.0o0r 1.01: 0x400088 [dword] [virtual protect 1] [EXE Content] 
Values: 
1. OxCA - GTA San Andreas v1.0 [US] HOOLDRUM No-CD Fixed EXE 


Ox8A - GTA San Andreas v1.0 [EURO] No-CD Fixed EXE 
OxF9 - GTA San Andreas v1.0 [EURO] Original 
OxDO - GTA: San Andreas v1.01 [EURO] No-CD/Fixed EXE 


ao 


Limits 
IPL Instances: 

Description: The max number of active IPL instances, inst section in .ipl 
files. Every placed object on map is in inst section. 

In Memory ( [dword ] [virtual protect 1] [EXE content] ): 

e In1.0: 0x55105F 

¢ In 1.01:0x14BE02A 

In EXE file ( [dword] ): 

e /n 1.01: OxCF602A 


Streaming memory limit ( [dword] [virtual protect 1] [EXE content] ): 
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Description: Amount of memory for loading textures around camera. 
When too many high-res textures are added to the game they disappear because 
there isnt enough memory to load. Increasing this limit solves texture loading 
problem. 

e /n 1.0: Ox8A5A80 

e /n 1.01: Ox8A6D4C 


Note: This value is overwritten 3 times during the loading of game. NOP 
following addresses to solve a problem: 
In 1.0: 
e Ox5B8EG64 - 10 bytes 
e Ox5BCD50 -5 bytes 
e Ox5BCD78 - 5 bytes 
In 1.01: 
e 0x5B9644 - 10 bytes 
° 0x5BD530 - 5 bytes 
e 0x5BD558 - 5 bytes 


Player 

Money ( [dword] ): 
Description: Base address to money in GTA San Andreas 
¢ In 1.0: OxB7CE50 
e /n1.01:0xB7F4D0 

This address: 

e + 0x0 = Current money value. 

e + 0x4 = Displayed number of money on the game HUD 


Time 
Current time ( [dword] ): 
Description: Base address to time in GTA San Andreas 
¢ In 1.0: OxB7014E 
¢ In 1.01: 0xB727CE 
This address: 
e + 0x0 [byte] = Current weekday (1 through 7) 
e + 0x4 [byte] = Current minute (0 to 59) 
e + 0x5 [byte] = Current hour (0 to 23) 
e + 0x6 [byte] = Current month day 
¢ + 0x7 [byte] = Current month (1 through 12) 
e + 0xA [byte] = Timer related to weather and time in ms, should not be 
modified 
e + OxE [dword] = Defines how many milliseconds takes one minute in game. 


Weather 

Weather settings: 
Description: Base address to weather settings. 
e /1n1.0: OxC81318 
e /n 1.01: OxC83AD4 

This address: 
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e + 0x0 [word] = Weather lock 
e + 0x4 [word] = Upcoming weather 
e + 0x8 [word] = Current weather 


CActor 

Actor is every spawned ped. Every spawned actor is described as object in 
memory. CActor contains actor properties, not model or anything else. 

It could be divided into two parts - main struct and pool. Main struct contains 
pointers + info about amount of present actors, while pool contains ped structs. 
Firstly pointer for main struct is necessary. 


Pointer to CActor main struct ( [dword] ): 
Description: Pointer to main struct that is described below. 
e /n1.0: OxB74490 
e /n 1.01: 0xB76B10 


Main struct 

¢ +0 ([dword] ) = Contains a pointer to the first element in the pool 

e +4 ([dword] ) = Contains a pointer to a byte map indicating which elements 
are in use. 

¢ +8 ([dword] ) = Is the maximum number of elements in the pool 

e +12 ( [dword] ) = Is the current number of elements in the pool 


Explanation of main struct: 


+ O contains a pointer to the first element in the pool. Every spawned ped is one 
of objects in pool. Each ped takes 1988 (0x7C4) bytes in pool. These 0x7C4 
bytes contain ped properties like health, location, tasks and so forth. 


+ 4 contains a pointer to a byte map where every byte concerns state of element 
in pool (exists or not) and necessary information to convert ped struct into 
handle. 


If ped exists on certain position in pool, then value on this position relative to 
byte map will range from OxO to 0x80. 


How to convert position of ped in pool/byte map to handle? 


HANDLE = POSITION_IN_BYTE_MAP* 256 + 
VALUE_FROM_BYTE_ON_THIS_POSITION_IN_BYTE_MAP 


Let’s say byte map is on 0x9000. 


We want to convert third ped struct/position to handle that may be used in SCM 
opcodes. 


Third ped state will be on 0x9001, position is +1 then. 


Let*s say value on 0x9002 is 0x34. 
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Handle = 2 * 256 + 0x34 


Handle = 564 


Actor struct 
It describes information about every active actor in pedestrian pool. Each actor 
takes 1988 (0x7C4) bytes in pool. 


e +14 XYZ position structure 


CVehicle - spawned vehicles 

CVehicle pool is memory area where is information about all currently spawned 
cars. This information contains car properties, location and so on. This pool does 
not contain loaded model or anything. 


Cheats 
Cheat string ( [ char[30] ] ): 
e Description: Buffer of last 30 typed chars on keyboard. Contains only 
printable characters like letters. Earlier typed chars are on next bytes. 
e /n 1.0: 0x969110 
e /n1.01:0x96B790 


Character set in buffer: 0123456789ABCDEFGHIJKMNOPQRSTUVXYZ 
Function calls ( [dwords] ): 
e Description: Function adresses when cheat gets enabled or disabled. 


If cheat doesn’t have a function, then value is 0x00 
¢ /n1.0:0x8A5B58 
¢ /n 1.01: Ox8A6E40 

Hashes ( [dwords] )_: 

° Description: GTASA_CRC32 hashes that are tested by initCheat function 
when end-user is typing on keyboard. 

e /n1.0:0x8A5CC8 
¢ /n 1.01: 0x8A6FBO 

States ( [dwords] ): 

° Description: Bytes with values 1/0 used to determine if toggleable cheat is 
currently enabled or disabled. It is used for cheats that can be both enabled 
and disabled. 

¢ /n1.0:0x969130 
¢ /n 1.01: 0x96B7BO 
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SCM Opcodes 


List of opcodes 


Camera 

NO003 = SET CAM SHAME wes isessavauas vesde usiduacvesiqutuoraventandnnsatasdavesusataidabuaxqutewawbevncenden 103 
Key 

ORS WS SIO a sac sacraces ance avecacnactasvicanmtorh swairwadnsesaas sanhamsapenatanmannsnaganeraies 170 
OABO = VitUall REY DSSS oes sectenncdnsverhaviatedvestasd Seayannbaedtnteegehnenneatiastuentioatneaaen 170 
Math 

0004 = Set: global 1Nt: Vala Dl Gs scdccws saves ctaaticcscesndan bass calsceesinns cinco ck uetsencdovensasbaanniiens 103 
0005 = Set global float: Varia ble sis icssicsccesccusecssvedssvncssaneiinderncses teantexeul niaussiaceedees 104 
OO0G= Set loCall INE Vala ble: cciwessernssiansernasctiesaaeteane st ectesssatamedeassenenndsse: 105 
OO07 = set local float Variable sis icciex sacs setts de dean satdutedeana cect ctdeanemeneWvasunenansdeadsnauees 105 
0008 - add_int_value_to_ global _variable.......... 0... ceecceeeceee eee ea eeeeeeeaeeaeeaeeaeeaee 106 
0009 - add _float_value_to_ global_variable........... 00... ceceee cesses eeeee eee eeeee een eeaes 106 
OOOA - add_int_value_to_ local _variable......... ce. cece ee eee eee eeeeeeaeeaeaeeaeeneeeae 107 
OOOB - add _float_value_to_local_variable.............. ccc cccececeee cece ener eee e eee eeeese eee enaes 108 
OOOC - subtract_int_value_from_global_variable.............ccccceceeeeeceeeeeeeeeeeeeeea tenes 108 
0OOD - subtract_float_value_from_global_variable.............. eee eeeeeee teense eee es 109 
OOOE - subtract_int_value_from_local_variable............ccceceeeeeeeeeeeeeeeeee eee eeneeaes 110 
OOOF - subtract_float_value_from_local_variable.............cccceeeeeeeeeeeeeeeeeeeaeeee tenes 110 
0010 - multiply _by_int_value_in_global_variable............. cece eeeneeeeeeeeeeeenees 111 
0011 - multiply_by_float_value_in_global_variable............. cece eeeeeeeeeeeeeeaa es 112 
0012 - multiply _by_int_value_in_local_ Variable... eee eeeeeeeeee erste eeeeneeeee 112 
0013 - multiply _by float_value_in_local_variable....... eee eeeeeeeee etna eeeeee 113 
0014 - divide _by_int_value_in_global_variable.............. cc cceeeceeeseeeeeeeeeeeeae een eeaes 114 
0015 - divide by _float_value_in_global_variable............ cece eecee eee eeeee eee tenes 114 
0016 - divide_by_int_value_in_local_variable...........ccccceceseeeeeeeeeeeseeseeeeeeeeeeesenees 115 
0017 - divide_by_float_value_in_local_Variable......... ce eeeeeeeeeteeeeeeeeeeeeeeeen enna 116 
0018 - is int_global variable greater than_vValue...........cccececeeeeeeeeeeee teeta eee eeea es 116 
0019 - is int_local variable greater than _Value...........ceeceeeeeee cece eeee eee eeeeeea tenes 117 
001A - is _int_value_greater than_global_variable.................ceeseeeeeeeeeeeneeeeeeeee es 118 
001B - is int_value_greater_than_local_Variable......... ce ceeeeeeeeeeeeeeee teen eeenn enna 119 
001C - is int_global_ variable greater _than_global_variable............. eee 120 
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001D - is int_local_ variable greater than_local_variable.............c eee 121 


OO1E - is _int_global variable greater than_local_variable............. eee 122 
OO1F - is int_local variable greater than global variable.............c eee 123 
0020 - is float_global_ variable greater than _value...........ccceeeeeeeeeeeeeee teeta 124 
0021 - is float_local variable greater than _vValue............ cece eeeeeeee eee eee eee eeaeeee es 125 
0022 - is float_value_greater than_global_variable............c cece eeeee eee eee ees 126 
0023 - is float_value_greater than_local_variable............ccccceceeeeeeeeeeee eee eeee es 127 
0024 - is float_global_ variable greater than_global_variable.............c ee 128 
0025 - is float_local_variable_greater_than_local_variable....... cc eeeeeeeeeeee ees 129 
0026 - is float_global_ variable greater than_local_variable............. cee 130 
0027 - is float_local_ variable greater than_global_variable..............ceee 131 
0028 - is int_global variable greater_or equal_to_valUe.......... ee eeeeeeeeeeee ees 132 
0029 - is int_local variable _greater_or equal to ValUe......... eect ee eeee es 133 
002A - is int_value_greater_or equal to global variable............ eee 134 
002B - is int_value_greater_or equal to local _variable........... eee 135 
002C - is int_global_ variable _greater_or equal _to global _variable................... 136 
002D - is _int_local_variable_greater_or_equal_to_local_variable............ ee 137 
002E - is _int_global_variable_greater_or_equal_to_local_variable.............. 138 
002F - is _int_local variable _greater_or_equal_to_ global variable.................. 139 
0030 - is float_global_ variable greater or equal to value.......... eee 140 
0031 - is float_local_ variable greater _or equal to valUe......... eee eeee es 141 
0032 - is float_value_greater_or equal _to global variable............. ee 142 
0033 - is float_value_greater_or equal _to local _variable............ eee 143 
0034 - is float_global_variable_greater_or equal_to global variable................ 144 
0034 - is float_global_variable_greater_or equal_to global variable................ 145 
0035 - is float_local_ variable greater _or_equal_to local variable..........0.0... 146 
0036 - is float_global_variable_greater_or equal_to local_variable.................. 147 
0037 - is float_local_ variable greater or equal_to_ global_variable................. 148 
0038 - is _int_global variable equal _to_ValUC...... eee cece eee eee eeeeeeeeneeeaeeeaes 149 
0039 - is int_local variable equal to Value... eee ete e eee ee ee eee een een eeaes 150 
003A - is _int_global_ variable equal to global _variable............. eee 151 
003B - is _int_local_variable_ equal_to_local_variable....... eee eeeeeeee eter eeen ee 152 
003C - is int_global_ variable equal to local _variable........... cc eeeeeee eee eee ees 153 
0042 - is float_global_ variable equal to ValUe....... eee eee eee e ee eeeeeeeaa tenes 154 
0043 - is float_local_ variable equal _to_ValUC......... eect ee eee ee eeeeeeeeeeee een eeaes 155 


Page 107 of 186 


0044 - is float_global_variable equal to global _variable............. eee 156 


0045 - is float_local_ variable _equal_to_local_variable....... cc eeeeeeeeeeeeee een ees 157 
0046 - is float_global_variable equal_to_local_variable......... ec eeeeeeeeeeeeeeee ees 158 
0058 - add _int_global variable to global _variable............. eee eeeeeeeeeeeeeee es 167 
0059 - add _float_global_ variable to global variable.............. eee eee 168 
005A - add_int_local_variable_to_local_variable..........cceceeeeeeeseeeeeeeeeeeeeeeeeneeeees 169 
NOP 

OO ae OP soit parade aces bra aachtra ea ncsanmeste sa keinsewes ness ote puedo hamne sue haunsthokvecsabadatinuataasaereaee 100 
OOS 2 = INOP GAS i xicaceentecewsateen tts iectwecsteane ene hannea beceslanpwent stan teeta eccieesensecneeseieanaes 165 
Player 

0033 =. CREATE PLAYER .aitensimctatis snsinansinisoneinesain sem ntaapesmnuneiia eal tneuaees oat Sekenwsiedeiwednadey 166 


SCM Structure opcodes 


0 B= WY AIM ceesaedseeesawantet van neanserazesageuiverseipeeitoanteeteuiawasabsanedstenabiaandoagecuentedeuareahey 101 
OOO = GOT 0 ice seetat eta tnteceneusrdensadini avant ceed aan pddaxedaataadduyabeces exananduan «Waldduwenetadders 102 
OOS i iT dll Sass seessunesaenseadtssaeatenmanaeaiaa samahs aie eeticnceasninaead.aetunietucaies 159 
DO4E = TERMINATE. THIS, SCRIP T iicsscecisceccscisuxnic sen cecsnasistiaainamianwedaiawebienacanniennan mseaaidiies 160 
OO4F — START NEW SCRIPT WITH, BAGS vcssassctcscsstenscedanessobvedactnsrintieteetacteoates 161 
OSD = OOS UD adicccdastcecieeseiacdecnaaten des eicuset ads ler indies tewinn dade educa sedate i euaeaatems 163 
NOS IS EI ic vicinciosscs tsanisecie atin he tuctenacereie sand acetwhssanisatulnat esanisntilicen dena neues euasaiesahismaskibewad 163 


Standard opcodes 

These opcodes exist in GTA San Andreas without installing anything and provide 
most powerful scripting in game. They provide biggest possibilities of creating 
missions, controlling world, including objects, peds, vehicles and so on. 


0000 - NOP 
Sanny Builder opcodes.txt: 0000: NOP 


Sanny Builder SASCM.INI: 0000=0,NOP 


Description: This opcode does absolutely nothing. 0000 is often put at the 
beginning of CLEO scripts to avoid jump-at-zero-offset bug 


Opcode definition: 


void NOP(); 


Parameters: 
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No parameters 


Returns true or false? No. 


Example in Sanny Builder: 


i a a ae ee a a a eS ee a ee ee Se ee Se eee 


{$CLEO} 
0000: NOP // there should be at least one opcode before the first 
referenced label - @label in example 


' :0000_nop 
| wait 0 
0000: NOP // there is no visible effect in game ' 


01E3: show text _1number styled GXT 'NUMBER' number 666 time 5000 style 1 
// 666 number will appear if script works 
jump @0000 nop 


ae a a a ga cae acs ee, we ee a me ea a ly ce a a fe Sea re acct a eet: Se eae ee ee ee 


0001 - WAIT 
Sanny Builder opcodes.txt: 0001: wait 0 ms 


Sanny Builder SASCM.INI: 0001=1,wait %1ld% ms 
Sanny Builder keyword: wait ( wait 0 ) 


Description: WAIT opcode stops processing of the current thread and let 
the GTA SA to process other active SCM threads and execute different actions. 
The number specifies a minimum number of milliseconds of current thread 
inactivity. When a number of milliseconds is less or equal to zero, then current 
thread will be executed as soon as possible. GTA SA stops the current thread, 
executes other actions and comes back to process this thread again until it 
encounters WAIT command again. 


Native name: WAIT 


Opcode definition: 


void wait (int time); 


Parameters: 


1) Passed: integer, time to wait expressed in milliseconds. 100 ms 
= 1 second 


Returns true or false? No. 
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Example in Sanny Builder: 
{$CLE0O} 
0000: NOP 
:0001 wait 
0001: wait 0 ms // Stops the thread and lets the game to perform other 
actions. 
01E3: show text _1number styled GXT 'NUMBER' number 666 time 5000 style 1 


// Number will appear if script works 
jump @0001 wait 


se phat et a a a a ee SN a le a et decency a oes mae act cat 


0002 - GOTO 
Sanny Builder opcodes.txt: 0002: jump @MAIN_177 


Sanny Builder SASCM.INI: 0002=1, jump %1lp% 
Sanny Builder keyword: jump (jump @label ) 

goto ( goto @label ) 
Native name: GOTO 


Description: Jumps the code to the specified offset called label. Label is 
negative number, offset relative to beginning of SCM file. 


Opcode definition: 


void goto (int offset); 


Parameters: 


1) Passed: integer, label - negative offset in script file. (OFFSET 
* -1) 


Returns true or false? No. 


Example in Sanny Builder 


{$CLEO} 
0000: NOP 


:0002 jump 

' wait 0 

: @1E3: show text_1number styled GXT 'NUMBER' number 666 time 5000 style 1 
! // 666 number will appear if script works 

' 0002: jump @0002_jump // It jumps to specific offset. 

' @0002 jump_example (label) is just negative INT number, offset of label 
| compiled SCM file. 


Page 110 of 186 


0003 - SET_CAM_SHAKE 


Sanny Builder opcodes.txt: 0003: shake camera 40 
Sanny Builder SASCM.INI: 0003=1,shake camera %1d% 


Sanny Builder keyword: shake_camera (shake_camera 40) 
Native name: SET CAM SHAKE 
Description: This opcode shakes a camera 


Opcode definition: 


void set_cam_ shake (int force) 


Parameters: 


1) Passed: integer, force of shaking camera. Time of shaking 
camera depends on this value. 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


:0003_shake_camera 

wait 0 

if 

OABO: key pressed 48 // 0 on left side of keyboard to press 
else_jump @0003_shake_camera 

0003: shake_camera force 2000 

jump @0003_shake_camera 


er ee ee 


Watch a video presenting opcode: 


0004 - set_global_int_variable 


Sanny Builder opcodes.txt: 0004: $CUSTOM TOURNAMENT FLAG = 0 

Sanny Builder SASCM.INI: 0004=2 ,%1d% = %2d% 

Sanny Builder short use: $CUSTOM TOURNAMENT FLAG = 0 

Description: Math opcode that assigns value of 4-byte size to variable. 


Should be used to assign integer value of global variable. 


Opcode definition: 


void set global int variable (int &Global variable, int Value); 


Parameters: 
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Sasetew 


1) Stored: integer, global variable 
2) Passed: integer, value to assign 


Returns true or false? No. 


Example in Sanny Builder: 


an “tS a sm mi mp Sa a i tin iy a myth a lS oi “fc i ki i 


01E4: show_text_1Inumber_lowpriority GXT 'NUMBER' number $8201 time 2000 
flag 1 // Number 92 will appear 
jump @0004 set_global_int_variable 


ES Da See ga rere eee ee a pn Oe ee Ce eee ORE OTR er er Re Te Te ee er re em oreo ee amen eee eee 


| {$CLEO} 

0000: NOP 
' :0004 set_global_int_variable 

' wait 0 
| 0004: $8201 = 92 // Global variable will get INT value 


0005 - set_global_float_variable 
Sanny Builder opcodes.txt: 0005: $166 = 292.33 


Sanny Builder SASCM.INI: 0005=2,%1d% = %2d% 
Sanny Builder short use: $166 = 292.33 


Description: Math opcode. It assigns value of 4-byte size to variable. Used 
to assign a float value a global variable. 


Opcode definition: 


void set global float variable (float &Global variable, float 
Value) ; 


Parameters: 


1) Stored: float, global variable 
2) Passed: float, value to assign 


Returns true or false? No. 


Example in Sanny Builder: 


ip a san ne ah ep ea cen a as, es Ea pc yc pa em gmc San ecm me ym pep a, ca cy cay eee seek ee tl at a ae ase a et Sas, 


OADO: show formatted text _lowpriority “tempvar: %f" time 2000 $TEMPVAR FLOAT 1 
jump @0005 set qlobal float variable 


' {$CLEO} 

1 // Example requires CLE04 installed. 

' 0000: NOP 

1 10005 set_global_float_variable 

‘ wait 0 

' 9005: $TEMPVAR FLOAT 1 = 783.5 // Global variable will get FLOAT value 


0006 - set_local_int_variable 
Sanny Builder opcodes.txt: 0006: 0@ = -1 
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Sanny Builder SASCM.INI: 0006=2,%1d% = %2d% 
Sanny Builder short use: 0@ = -1 


Description: Math opcode. It assigns value of 4-byte size to variable. 
Should be used to assign integer value to a local variable. 


Opcode definition: 


void set_local_int variable (int &Local_ variable, int Value); 


Parameters: 


1) Stored: integer, local variable 
2) Passed: integer, value to assign 


Returns true or false? No. 


Example in Sanny Builder: 


01E4: show text _1number lowpriority GXT 'NUMBER' number 0@ time 2000 flag 1 
// 666 from local 0@ will appear 
jump @0006_set_local_int_variable 


' {$CLEO} | 
' 9000: NOP 
: :0006_set_local_int_variable ! 
‘wait 0 
' 0006: O@ = 666 // 0@ local variable will get INT value 


0007 - set_local_float_variable 


Sanny Builder opcodes.txt: 0007: 7@ = 0.0 


Sanny Builder SASCM.INI: 0007=2,%1d% = %2d% 


Sanny Builder short use: 0@ = 42.5 
Description: Math opcode. It assigns value of 4-byte size to variable. Used 
to assign a float value to a local variable. 


Opcode definition: 


void set local float variable (float S&Local variable, float Value); 


Parameters: 


1) Stored: float, local variable 
2) Passed: float, value to assign 


Returns true or false? No. 
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Example in Sanny Builder: 


{$CLE0} 
// Example requires CLE04 installed 
0000: NOP 


wait 0 
0007: 0@ = 43.5 


OADO: show formatted text_lowpriority “local var float value: %f" time 2000 0@ 


:0007_set_local_float_variable 


jump @0007_set_local_float_variable 


0008 - add_int_value_to_global_variable 
Sanny Builder opcodes.txt: 0008: $89 += 1 


Sanny Builder SASCM.INI: 0008=2 ,%1d% += %2d% 
Sanny Builder short use: $89 += 1 


Description: Math opcode. Adds the specified Integer value to the value 
stored in the Global Variable. 


Opcode definition: 


void add int value to global variable (int &Global variable, int 
Value); 


Parameters: 


1) Stored: integer, global variable 
2) Passed: integer, value to add 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 
$89 = 0 


0008: $89 += 1 // add 1, incrementation once a second 


01E4: show text _1number lowpriority GXT 'NUMBER' number $89 time 2000 flag 1 


wait 1000 


:0008 add_int_value_to_global_int_variable 
jump @0008 add int value to global_int variable 


0009 - add_float_value_to_global_variable 
Sanny Builder opcodes.txt: 0009: $TEMPVAR FLOAT 1 += 1.741 


Sanny Builder SASCM.INI: 0009=2,%1d% += %2d% 


Sanny Builder short use: $TEMPVAR FLOAT 1 += 1.741 


Page 114 of 186 


SSSA 


Description: Math opcode. Adds the specified float value to the value 
stored in the Global Variable. 


Opcode definition: 


void add float value to global variable (float &Global variable, 
float Value) ; 


Parameters: 


1) Stored: float, global variable 
2) Passed: float, value to add 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 installed 
0000: NOP 


:0009 add_float_value_to global_int_variable 
wait 0 
$TEMPVAR FLOAT 1 = 10.0 
0009: $TEMPVAR FLOAT 1 += 2.5 // result = 12.5 

OADO: show formatted text_lowpriority “global float var value: %f" time 2000 


$TEMPVAR FLOAT 1 
jump @0009_add_float_value_to_global_int_variable 


000A - add_int_value_to_local_variable 
Sanny Builder opcodes.txt: 000A: 3@ += 3000 


Sanny Builder SASCM.INI: Q00A=2,%1d% += %2d% 
Sanny Builder short use: 3@ += 3000 


Description: Math opcode. Adds the specified Integer value to the value 
stored in the Local Variable. 


Opcode definition: 


void add int value to local variable (int &Local variable, int 
Value); 


Parameters: 


1) Stored: integer, local variable 
2) Passed: integer, value to add 


Returns true or false? No. 
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Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


| :000A_add_int_value_to_local_variable ! 
1 O1E5: show text_1number highpriority GXT 'NUMBER' number 3@ time 5000 flag 1 
000A: 3@ += 10 // Value is increased by 10 once a second 

' wait 1000 
' jump @Q000A_add_int_value_to_local_variable 


OOOB - add_float_value_to_local_variable 
Sanny Builder opcodes.txt: Q00B: 6@ += 0.1 


Sanny Builder SASCM.INI: Q00B=2,%1d% += %2d% 
Sanny Builder short use: 6@ += 0.1 


Description: Math opcode. Adds the specified float value to the value 
stored in the Local Variable. 


Opcode definition: 


void add float value to local variable (float S&Local variable, 
float Value) ; 


Parameters: 


1) Stored: float, local variable 
2) Passed: float, value to add 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLE0} 
// Example requires CLE04 installed 
0000: NOP 


OAD1: show formatted text_highpriority “local float var value: %f" time 200 2@ 
OO0OB: 2@ += 0.5 // Value is increased by 0.5 once a second 

wait 1000 

iump @000B add float value to local variable 


Db sys fe fat ae tsa, ei a ote mf rt Pc gh ea ig ee en hl a ch a an, a at a ES ar a, te a gees a 


:000B_add_float_value_to_local_variable 


OOOC - subtract_int_value_from_global_variable 
Sanny Builder opcodes.txt: 000C: $1020 -= 1 


Sanny Builder SASCM.INI: 000C=2,%1d% -= %2d% 


Sanny Builder short use: $1020 -= 1 
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Description: Math opcode. Subtracts the specified integer value from the 
value stored in the Global Variable. 


Opcode definition: 


void subtract int value from global variable (int &Global variable, 
int Value); 


Parameters: 


1) Stored: integer, global variable 
2) Passed: integer, value to subtract 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


:000C_subtract_int_value_from_global_variable 
; wait 0 

1 $89 = 90 
1 QOOC: $89 -= 40 // Result = 50 

' O1E5: show _text_Inumber_highpriority GXT 'NUMBER' number $89 time 5000 flag 1 
! jump @000C_subtract_int_value_from_global_variable 


00O0D - subtract_float_value_from_global_variable 
Sanny Builder opcodes.txt: 000D: $TEMPVAR Z COORD -= 0.5 


Sanny Builder SASCM.INI: Q00D=2,%1d% -= %2d% 
Sanny Builder short use: $TEMPVAR Z COORD -= 0.5 


Description: Math opcode. Subtracts the specified float value from the 
value stored in the Global Variable. 


Opcode definition: 


void subtract float _value from global variable (float 
&Global variable, float Value); 


Parameters: 


1) Stored: float, global variable 
2) Passed: float, value to subtract 


Returns true or false? No. 
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Example in Sanny Builder: 


{$CLE0} 
// Example requires CLE04 installed 
0000: NOP 


:000D_ subtract_float_value_from_global_variable 
; wait 0 

1 $tempvar Float_1 = 2.3 

: Q00D: $tempvar Float_l -= 0.2 // Result = 2.1 


@AD1: show formatted text _highpriority "global float var value: %f" time 200 


$tempvar_ Float_1 
jump @000D subtract float value from global variable 


OOOE - subtract_int_value_from_local_variable 
Sanny Builder opcodes.txt: Q00E: 0@ -= 1 


Sanny Builder SASCM.INI: QQ0QE=2,%1d% -= %2d% 
Sanny Builder short use: 0@ -= 1 


Description: Math opcode. Subtracts the specified integer value from the 
value stored in the Local Variable. 


Opcode definition: 


void subtract_int_ value from local variable (int S&Local variable, 
int Value) ; 


Parameters: 


1) Stored: integer, local variable 
2) Passed: integer, value to subtract 


Returns true or false? No. 


Example in Sanny Builder: 


' £$CLEO} 
0000: NOP 


:000E_subtract_int_value_from_local_variable 
' wait 0 

1 O@ = 47 

OQ0E: 0@ -= 5 £Y/ Result = 42 


01E5: show text _1number highpriority GXT 'NUMBER' number 0@ time 5000 flag 1 


jump @Q00E_subtract_int_value_from_local_variable 


OOOF - subtract_float_value_from_local_variable 
Sanny Builder opcodes.txt: Q00F: 692@ -= 8.0 


Sanny Builder SASCM.INI: Q00F=2,%1d% -= %2d% 
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So aa | 


Sanny Builder short use: 692@ -= 8.0 


Description: Math opcode. Subtracts the specified float value from the 
value stored in the Local Variable. 


Opcode definition: 


void subtract float value from local variable (float 
&Local variable, float Value); 


Parameters: 


1) Stored: float, local variable 
2) Passed: float, value to subtract 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


:000F_subtract_float_value_from_local_variable 

' wait 0 

1; O@ = 47.5 

| OOOF: 0@ -= 3.0 // Result = 44.5 

OAD1: show formatted text_highpriority "local float var value: %f" time 200 0@ 
' jump @Q00F_subtract_float_value_from_local_variable 


0010 - multiply_by_int_value_in_global_variable 
Sanny Builder opcodes.txt: 0010: $GS GANG CASH *= 100 


Sanny Builder SASCM.INI: 0010: $GS GANG CASH *= 100 
Sanny Builder short use: $GS_ GANG CASH *= 100 


Description: Math opcode. Multiplies the value stored in the Global Variable 
by the specified Integer value. 


Opcode definition: 


void multiply by int value in global variable (int 
&Global variable, int Value); 


Parameters: 


1) Stored: integer, global variable 
2) Passed: integer, value to multiply by 


Returns true or false? No. 
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Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


:0010 multiply_by_int_value_in_global_variable 

' wait 0 

1 $89 = 5 

| 0010: $89 *= 10 // Result = 50 

01E5: show text _1number highpriority GXT 'NUMBER' number $89 time 5000 flag 1 
' jump @0010_multiply_by_int_value_in_ global_variable 


0011 - multiply_by_float_value_in_global_variable 
Sanny Builder opcodes.txt: 0011: $HJ_ TEMP FLOAT *= 100.0 


Sanny Builder SASCM.INI:  0011=2,%1d% *= %2d% 
Sanny Builder short use: $HJ_TEMP_ FLOAT *= 100.0 


Description: Math opcode. Multiplies the value stored in the Global Variable 
by the specified Float value. 


Opcode definition: 


void multiply by float value in global variable (float 
&Global variable, float Value); 


Parameters: 


1) Stored: float, global variable 
2) Passed: float, value to multiply by 


Returns true or false? No. 
Example in Sanny Builder: 


OAD1: show formatted text highpriority “global float var value: %f" time 200 
$tempvar_ Float_1 
jump @0011 multiply by float value in qlobal variable 


1 {$CLEO} 

1 // Example requires CLE04 

: 000: NOP 

' :0011_multiply_by_float_value_in_global_variable 

; wait 0 

| $tempvar_Float_1 = 5.0 

‘ QO11: $tempvar_Float_1 *= 100.0 // Result = 500.0 


0012 - multiply_by_int_value_in_local_variable 
Sanny Builder opcodes.txt: 0012: 22@ *= -1 


Sanny Builder SASCM.INI:  0012=2,%1d% *= %2d% 
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Sanny Builder short use: 22@ *= -1 


Description: Math opcode. Multiplies the value stored in the Local Variable 
by the specified Integer value. 


Opcode definition: 


void multiply by int value _in local variable (int &Local variable, 
int Value) ; 


Parameters: 


1) Stored: integer, local variable 
2) Passed: integer, value to multiply by 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


:0012 multiply_by_int_value_in_local_variable 
; wait 0 
1 0@=5 
: Q012: O@ *= 2 // Result = 10 
' O1E5: show _text_lnumber_ highpriority GXT 'NUMBER' number 0@ time 5000 flag 1 
' jump @0012 multiply_by_int_value_in local variable 


0013 - multiply_by_float_value_in_local_variable 
Sanny Builder opcodes.txt: 0013: 17@ *= 9.8 


Sanny Builder SASCM.INI: 0013=2,%1d% *= %2d% 
Sanny Builder short use: 17@ *= 9.8 


Description: Math opcode. Multiplies the value stored in the Local Variable 
by the specified Float value. 


Opcode definition: 


void multiply by float_value in local variable (float 
&Local variable, float Value); 


Parameters: 


1) Stored: float, local variable 
2) Passed: float, value to multiply by 


Returns true or false? No. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


wait 0 
0@ = 2.5 
0013: 0@ *= 2.0 // Result = 5.0 


OAD1: show formatted text_highpriority “local var float value: %f" time 200 0@ 


:0013_multiply_by_float_value_in_local_variable 


iump @0013 multiolv bv float value in local variable 


0014 - divide_by_int_value_in_global_variable 
Sanny Builder opcodes.txt: 0014: $HJ TWOWHEELS TIME /= 1000 


Sanny Builder SASCM.INI: 0014=2,%1d% /= %2d% 
Sanny Builder short use: $HJ TWOWHEELS TIME /= 1000 


Description: Math opcode. Divides the value stored in the Global Variable 
by the specified Integer value. 


Opcode definition: 


void divide by int value in global variable (int &Global variable, 
int Value) ; 


Parameters: 


1) Stored: integer, global variable 
2) Passed: integer, value to multiply by 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


:0014 divide_by_int_value_in_global_variable 
' wait 0 

| $89 = 10 

| 0014: $89 /= 5 // Result = 2 


01E5: show text _1Inumber highpriority GXT ‘'NUMBER' number $89 time 5000 flag 1 


jump @0014 divide bv int value in alobal variable 


0015 - divide_by_float_value_in_global_variable 


Sanny Builder opcodes.txt: 0015: $EXPORT PRICE HEALTH MULTIPLIER /= 1000 


Sanny Builder SASCM.INI:  0015=2,%1d% /= %2d% 


Sanny Builder short use: $EXPORT PRICE HEALTH MULTIPLIER /= 1000 
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Description: Math opcode. Divides the value stored in the Global Variable 
by the specified Float value. 


Opcode definition: 


void divide by float value in global variable (float 
&Global variable, float Value); 


Parameters: 


1) Stored: float, global variable 
2) Passed: float, value to multiply by 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0015 divide _by_float_value_in_global_variable 

| wait 0 

i $tempvar Float_1 = 5.0 

| Q015: $tempvar Float_l /= 2.5 // Result = 2.0 


OAD1: show formatted text highpriority “global var float value: %f" time 200 
$tempvar Float 1 


iumn @AA15 divide hv float value in alohal variahle 


0016 - divide_by_int_value_in_local_variable 
Sanny Builder opcodes.txt: 0016: 4@ /= 2 


Sanny Builder SASCM.INI: 0016=2,%1d% /= %2d% 
Sanny Builder short use: 4@ /= 2 


Description: Math opcode. Divides the value stored in the Local Variable by 
the specified Integer value. 


Opcode definition: 


void divide by int value in local variable (int &Local variable, int 
Value); 


Parameters: 


1) Stored: integer, local variable 
2) Passed: integer, value to multiply by 


Returns true or false? No. 
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Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


:0016_divide_by_ int_value_in_local_variable 
wait 0 

4@ = 8 

0016: 4@ /=2 £=// Result = 4 


iump @0016 divide bv int value in local variable 


0017 - divide_by_float_value_in_local_variable 
Sanny Builder opcodes.txt: 0017: 14@ /= 1000.0 


Sanny Builder SASCM.INI: 0017=2,%1d% /= %2d% 
Sanny Builder short use: 14@ /= 1000.0 


Description: Math opcode. Divides the value stored in the Local Variable by 
the specified Float value. 


Opcode definition: 


01E5: show text _1number highpriority GXT ‘NUMBER' number 4@ time 5000 flag 1 


void divide by float_value in local variable (float &Local variable, 
float Value) ; 


Parameters: 


1) Stored: float, local variable 
2) Passed: float, value to multiply by 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0017_divide_by_ float_value_in_local_variable 
wait 0 

14@ = 6000.0 

0017: 14@ /= 1000.0 // Result = 6.0 


OAD1: show _formatted text_highpriority "local var float value: %f" time 200 
14@ 
jump @0017 divide by_float_value_in_local_variable 


00168 - is_int_global_variable_greater_than_value 
Sanny Builder opcodes.txt: 0018: $CATALINA TOTAL PASSED MISSIONS > 2 
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-a 


-4 


Sanny Builder SASCM.INI: 0018=2, %1ld% > %2d% 
Sanny Builder short use: $CATALINA TOTAL PASSED MISSIONS > 2 


Description: Math opcode. Checks if Integer value stored in Global variable 
is greater than Integer value passed in second parameter. 


Opcode definition: 


bool is int global variable greater than value (int Global variable, 
int Value) 


Parameters: 


1) Passed: Integer, Global variable, supposed as greater 
2) Passed: Integer, value to compare first parameter with 


Returns true or false? Yes. 


Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0018 is _int_global_variable_greater_than_value 
wait 0 
$98 = 530 


a6 

0018: $98 > 150 

then 

OAD1: show formatted text highpriority "Global variable is greater than 
value 150" time 2000 // It will appear 

else 

OAD1: show formatted text _highpriority "Global variable is lower than 
value 150" time 2000 

end 
iump @0018 is int alobal variable areater than value 


0019 - is _int_local_variable_greater_than_value 
Sanny Builder opcodes.txt: 0019: 0@> 0 


Sanny Builder SASCM.INI: 0019=2, %1ld% > %2d% 
Sanny Builder short use: 0@ > 0 


Description: Math opcode. Checks if Integer value stored in Local variable 
is greater than Integer value passed in second parameter. 


Opcode definition: 
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bool is_int_local variable greater than value (int Local variable, 


int Value); 


Parameters: 


1) Passed: Integer, Local variable, supposed as 
greater 

2) Passed: Integer, value to compare first parameter 
with Returns true or 


false? Yes. 


Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0019 is _int_local_variable_greater_than_value 
wait 0 
0@ = 101 

if 

0019: 0@ > 100 

then 

OAD1: show formatted text highpriority “Local variable is greater than 
value 100" time 2000 // It will appear 

else 

OAD1: show formatted text highpriority “Local variable is lower than 
value 100" time 2000 

end 
iump @0019 is int local variable areater than value 


001A - is_int_value_greater_than_global_variable 
Sanny Builder opcodes.txt: 001A: 10 > $SYNDICATE TOTAL PASSED MISSIONS 


Sanny Builder SASCM.INI: O01A=2, %ld% > %2d% 
Sanny Builder short use: —_10 > $SYNDICATE TOTAL PASSED MISSIONS 


Description: Math opcode. Checks if first parameter, given Integer value is 
greater than the value stored in Global variable - returns true if value stored in 
Global variable is lower than given value. 


Opcode definition: 


bool is int value greater than global variable (int Value , int 
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Parameters: 


1) Passed: Integer, value supposed as greater 
2) Passed: Integer, Global variable, variable to compare value 


Returns true or false? Yes. 


Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:001A_is_int_value_greater_than_global_variable 
wait 0 


if 

OO1A: 35 > $98 

then 

OAD1: show formatted text _highpriority "Global variable is lower than 
value 35" time 2000 // It will appear 

else 

OAD1: show formatted text highpriority "Global variable is greater than 
value 35" time 2000 

end 
iump @001A is int value areater than alobal variable 


001B - is_int_value_greater_than_local_variable 
Sanny Builder opcodes.txt: 001B: 3 > 20@ 


Sanny Builder SASCM.INI: O01b=2, %ld% > %2d% 
Sanny Builder short use: 3 > 20@ 


Description: Math opcode. Checks if first parameter, given Integer value is 
greater than the value stored in Local variable - returns true if value stored in 
Local variable is lower than given value. 


Opcode definition: 


bool is int value greater than local variable (int Value , int 


Parameters: 


1) Passed: Integer, value supposed as greater 
2) Passed: Integer, Local variable, variable to compare value with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:001B_is_int_value_greater_than_local_variable 
wait 0 
20@ = 1 


if 

001B: 3 > 20@ 

then 

OAD1: show _formatted text_highpriority "INT Value from above is greater 
than value from local variable" time 2000 // It will appear 

else 

OAD1: show formatted text_highpriority “INT Value from above is lower 
than value from local variable" time 2000 

end 
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001C - is_int_global_variable_greater_than_global_variable 
Sanny Builder opcodes.txt: 001C: |= $CURRENT MONTH DAY > 
$GYM MONTH DAY WHEN LIMIT REACHED // (int) 


Sanny Builder SASCM.INI: 0O0lc=2, %ld% > %2d% ; (int) 


Sanny Builder short use: $CURRENT MONTH DAY > 
$GYM MONTH DAY WHEN LIMIT REACHED 


Variable types must be declared before. 


Description: Math opcode. Checks if first global integer variable is greater 
than the second global variable and returns true or false. 


Opcode definition: 


bool is int global variable greater than global variable (int 


Global _ variable , int Global variable) 


Parameters: 


1) Passed: Integer, Global variable, supposed as greater 
2) Passed: Integer, Global variable, variable to compare first 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:001C_is int_global_variable_greater_than_global_variable 
wait 0 


001C: $89 > $90 // (int) 


OAD1: show _formatted text_highpriority “INT first variable is greater 
than the second" time 2000 // It will appear 

else 

OAD1: show formatted text highpriority “INT first variable is lower than 
the second" time 2000 

end 


# 
h 


001D - is_int_local_variable_greater_than_local_variable 
Sanny Builder opcodes.txt: 001D: 27@ > 33@ // (int) 


Sanny Builder SASCM.INI: Q0Q1d=2, %ld% > %2d% ; (int) 
Sanny Builder short use: 27@ > 33@ 
Variable types must be declared before. 


Description: Math opcode. Checks if first local integer variable is greater 
than the second local variable and returns true or false. 


Opcode definition: 


bool is_ int local variable greater than local variable (int Local variable 


, int Local variable) 


Parameters: 


1) Passed: Integer, Local variable, supposed as greater 
2) Passed: Integer, Local variable, variable to compare first 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLEO} 
// Example requires CLE04 
0000: NOP 
:001D_is_int_local_variable_greater_than_local_variable 
wait 0 
0@ = 50 // bigger 
1@ = 20 
if 
001D: 06@>1@ // (int) 
then 


OAD1: show _formatted text_highpriority “INT first variable is greater 
than the second" time 2000 // It will appear 

else 

OAD1: show fomatted text highpriority "INT first variable is lower than 
the second" time 2000 

end 


OO1E - is_int_global_variable_greater_than_local_variable 
Sanny Builder opcodes.txt: 001E: |= $CURRENT TIME IN MS2 > 3@ // (int) 


Sanny Builder SASCM.INI: QQ1E=2, %ld% > %2d% ; (int) 
Sanny Builder short use: $CURRENT TIME IN MS2 > 3@ 
Variable types must be declared before. 


Description: Math opcode. Checks if the integer value of first global 
variable is greater than the value of second local variable and returns true or 
false. 


Opcode definition: 


bool is int global variable greater than local variable (int 


Global _ variable , int Local variable) 


Parameters: 


1) Passed: Integer, Global variable, supposed as greater 
2) Passed: Integer, Local variable, variable to compare first 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0} 
// Example requires CLE04 
0000: NOP 
:001E_is_int_global_variable_greater_than_local_variable 
wait 0 
$89 = 60 // bigger 
0@ = 55 // smaller 
if 
OO1E: $89 > 0@ Y (int) 
then 


OAD1: show _formatted text_highpriority “INT first variable is greater 
than the second" time 2000 // It will appear 

else 

OAD1: show fomatted text _highpriority “INT first variable is lower than 
the second" time 2000 

end 


O0O1F - is _int_local_variable_greater_than_global_variable 
Sanny Builder opcodes.txt: 001F: 9@ > $GIRL_PROGRESS[0] // (int) 


Sanny Builder SASCM.INI: Q001f=2, %ld% > %2d% ; (int) 
Sanny Builder short use: 9@ > $GIRL_PROGRESS[0] 
Variable types must be declared before. 


Description: Math opcode. Checks if the integer value of first local variable 
is greater than the value of second local variable and returns true or false. 


Opcode definition: 


bool is_int_local variable greater than global variable (int 


Local _variable , int Global variable) 


Parameters: 


1) Passed: Integer, Local variable, supposed as greater 
2) Passed: Integer, Global variable, variable to compare first 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 
:001F_ is int_local_variable_greater_than_global_variable 
wait 0 
0@ = 60 // bigger 
$89 = 55 // smaller 
if 
OO1F: 0@ > $89 // (int) 
then 


OAD1: show formatted text_highpriority “INT first variable is greater 
than the second" time 2000 // It will appear 

else 

OAD1: show fomatted text _highpriority “INT first variable is lower than 
the second" time 2000 

end 


0020 - is_float_global_variable_greater_than_value 
Sanny Builder opcodes.txt: 0020: $HJ_TWOWHEELS DISTANCE FLOAT > 0.0 


Sanny Builder SASCM.INI: 0020=2, %ld% > %2d% 
Sanny Builder short use: $HJ_ TWOWHEELS DISTANCE FLOAT > 0.0 


Description: Math opcode. Checks if Float value stored in Global variable is 
greater than Float value passed in second parameter. 


Opcode definition: 


bool is float global variable greater than value (float Global variable, 
float Value) 


Parameters: 


1) Passed: Float, Global variable, supposed as greater 
2) Passed: Float, value to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0020_is_ float_global_variable_greater_than_value 
wait 0 
$tempvar Float_1 = 2.5 


if 

0020: $tempvar Float_1 > 2.2 
then 

OAD1: show _formatted text_highpriority "FLOAT first variable is greater 
than the value" time 2000 // It will appear 

else 

OAD1: show _fomatted text_highpriority “FLOAT first variable is lower 

; than the value time" 2000 

end 


0021 - is _float_local_variable_greater_than_value 
Sanny Builder opcodes.txt: 0021:  26@ > 64.0 


Sanny Builder SASCM.INI: 0021=2, %ld% > %2d% 
Sanny Builder short use: 26@ > 64.0 


Description: Math opcode. Checks if Float value stored in Local variable is 
greater than Float value passed in second parameter. 


Opcode definition: 


bool is float local variable greater than value (float Local variable, 


float Value) 


Parameters: 


1) Passed: Float, Local variable, supposed as greater 
2) Passed: Float, value to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0021 is float_local_variable_greater_than_value 
' wait 0 
26@ = 70.0 
| af : 
0021: 26@ > 64.0 
; then 
OAD1: show formatted _text_highpriority "FLOAT first variable is greater 
than the value" time 2000 // It will appear 
else 
OAD1: show _fomatted text_highpriority “FLOAT first variable is lower 
i than the value time" 2000 
end 
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0022 - is_float_value_greater_than_global_variable 
Sanny Builder opcodes.txt: 0022: -180.0 > $1316 


Sanny Builder SASCM.INI: 0022=2, %ld% > %2d% 
Sanny Builder short use: -180.0 > $1316 


Description: Math opcode. Checks if Float value is greater than the value 
stored in Global variable. 


Opcode definition: 


bool is float value greater than global variable (float Value, float 


Global variable) 


Parameters: 


1) Passed: Float, value supposed as greater 
2) Passed: Float, Global variable to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0022 is float_value_greater_than_global_variable 
wait 0 
$tempvar_Float_1 = 70.0 


if 

0022: 80.0 > $tempvar_Float_1 
then 

OAD1: show _formatted text_highpriority "FLOAT checked value is greater 
than the value in global variable" time 2000 // It will appear 

else 

OAD1: show _fomatted text_highpriority "FLOAT checked value is lower than 
; the value in global variable" 2000 

end 


0023 - is_float_value_greater_than_local_variable 
Sanny Builder opcodes.txt: 0023: 0.0 > 7@ 


Sanny Builder SASCM.INI: 0023=2, %ld% > %2d% 
Sanny Builder short use: 0.0 > 7@ 


Description: Math opcode. Checks if Float value is greater than the value 
stored in Local variable. 


Opcode definition: 


bool is float value greater than local variable (float Value, float 
Local variable) 


Parameters: 


1) Passed: Float, value supposed as greater 
2) Passed: Float, Local variable to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0023_is_ float_value_greater_than_local_variable 
wait 0 
0@ = 20.0 


if 

0023: 30.5 > 0@ 
then 

OAD1: show _formatted text_highpriority "FLOAT checked value is greater 
than the value in local variable" time 2000 // It will appear 

! else 

OAD1: show _fomatted text_highpriority "FLOAT checked value is lower than 
; the value in local variable" 2000 

end 


0024 - is float_global_variable_greater_than_global_variable 
Sanny Builder opcodes.txt: 0024: $HJ CAR Z > $HJ CAR Z MAX // (float) 


Sanny Builder SASCM.INI: 0024=2, ‘%ld% > %2d% ; (float) 
Sanny Builder short use: $HJ CAR Z > $HJ CAR Z MAX 
Variable types must be declared before. 


Description: Math opcode. Checks if the Float value of first global variable 
is greater than the value of second global variable and returns true or false. 


Opcode definition: 


bool is float global variable greater than global variable (float 


Global _ variable, float Global variable) 


Parameters: 


1) Passed: Float, Global variable, supposed as greater 
2) Passed: Float, Global variable, variable to compare first variable 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0024 is float_value_greater_than_local_variable 
wait 0 


$tempvar Float_1 = 30.0 
$tempvar_Float_2 = 25.0 
% 9 
then 


OAD1: show _formatted text_highpriority "FLOAT checked value of first 
global var is greater than the value in second global variable" time 2000 
// It will appear 

else 

OAD1: show _formatted text_highpriority "FLOAT checked value of first 
global var is lower than the value in second global variable" 2000 


0024: $tempvar Float 1 > $tempvar Float 2 // (float) 
end 


0025 - is _float_local_variable_greater_than_local_variable 
Sanny Builder opcodes.txt: 0025: 3@> 6@ // (float) 


Sanny Builder SASCM.INI: 0025=2, %ld% > %2d% ; (float) 
Sanny Builder short use: 3@ > 6@ 
Variable types must be declared before. 


Description: Math opcode. Checks if the Float value of first local variable is 
greater than the value of second local variable and returns true or false. 


Opcode definition: 


bool is float local variable greater than local variable (float 


Local variable, float Local variable) 


Parameters: 


1) Passed: Float, Local variable, supposed as greater 
2) Passed: Float, Local variable, variable to compare first variable 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0025 is float_local_variable_greater_than_local_variable 
wait 
0@ = 


NBO] 


4 
2 


if 
0025: 0@>1@ // (float) 
then 
OAD1: show _formatted text_highpriority "FLOAT checked value of first 
local var is greater than the value in second local variable" time 2000 // , 
It will appear 
else 
OAD1: show _formatted text_highpriority "FLOAT checked value of first 
local var is lower than the value in second local variable" 2000 
end 


0026 - is_float_global_variable_greater_than_local_variable 
Sanny Builder opcodes.txt: 0026: = $TEMPVAR FLOAT 1 > 513@(227@,10f) // 
(float) 


Sanny Builder SASCM.INI: 0026=2, ‘%ld% > %2d% ; (float) 
Sanny Builder short use: $TEMPVAR FLOAT 1 > 513@(227@, 10f) 
Variable types must be declared before. 


Description: Math opcode. Checks if the Float value of first global variable 
is greater than the value of second local variable and returns true or false. 


Opcode definition: 


bool is float global variable greater than local variable (float 


Global variable, float Local variable) 


Parameters: 


1) Passed: Float, Global variable, supposed as greater 
2) Passed: Float, Local variable, variable to compare first variable 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0} 
// Example requires CLE04 
0000: NOP 
:0026 is float_global_variable_greater_than_local_variable 
wait 0 
$TEMPVAR FLOAT 1 = 5.5 // none of variables is greater... 
0@ = 5.5 
Lt 
then 


OAD1: show _formatted text_highpriority "FLOAT checked value of first 
global var is greater than the value in second local variable" time 2000 

else 

OAD1: show _formatted text_highpriority "FLOAT checked value of first 
global var is not greater than the value in second local variable" 2000 // 
It will appear 


0026: $TEMPVAR FLOAT 1 > 0@ // (float) 
end ! 


0027 - is_float_local_variable_greater_than_global_variable 
Sanny Builder opcodes.txt: 0027: 513@(227@,10f) > $TEMPVAR FLOAT 2 // 
(float) 


Sanny Builder SASCM.INI: 0027=2, ‘%ld% > %2d% ; (float) 
Sanny Builder short use: 513@(227@,10f) > $TEMPVAR FLOAT 2 
Variable types must be declared before. 


Description: Math opcode. Checks if the Float value of first local variable is 
greater than the value of second global variable and returns true or false. 


Opcode definition: 


bool is float local variable greater than global variable (float 


Local variable, float Global variable) 


Parameters: 


1) Passed: Float, Local variable, supposed as greater 
2) Passed: Float, Global variable to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLEO} 
// Example requires CLE04 
0000: NOP 


:0027_is float_local_variable_greater_than_global_variable 
wait 0 
@@ = 5.5 // none of variables is greater... 
$TEMPVAR FLOAT 1 = 5.5 
Lf 
0027:  0@ > $TEMPVAR FLOAT 1 // (float) 
then 
OAD1: show _formatted text_highpriority "FLOAT checked value of first 
local var is greater than the value in second global variable" time 2000 
else 
OAD1: show _formatted text_highpriority "FLOAT checked value of first 
local var is not greater than the value in second global variable" 2000 // '! 
It will appear 
end 


00268 - is_int_global_variable_greater_or_equal_to_ value 
Sanny Builder opcodes.txt: 0028: $5283 >= 180000 


Sanny Builder SASCM.INI: 0028=2, %ld% >= %2d% 
Sanny Builder short use: $5283 >= 180000 


Description: Math opcode. Checks if Integer value stored in Global variable 
is greater or equal to Integer value passed in second parameter. 


Opcode definition: 


bool is int global variable greater or equal to value (int 


Global variable, int Value) 


Parameters: 


1) Passed: Integer, Global variable, supposed as greater or equal 
2) Passed: Integer, value to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0028 is int_global_variable_greater_or_equal_to value 
wait 0 
$89 = 67 


| if 

; 0028: $89 >= 67 
then 

OAD1: show formatted text highpriority "INT value of global variable is 
i greater or equal to value above" time 2000 

else 

OAD1: show formatted text highpriority "INT value of global variable is 
; Lower than value above" 2000 // It will appear 

end 
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0029 - is _int_local_variable_greater_or_equal_to_ value 
Sanny Builder opcodes.txt: 0029: 17@ >= 4 


Sanny Builder SASCM.INI: 0029=2, %ld% >= %2d% 
Sanny Builder short use: 17@ >= 4 


Description: Math opcode. Checks if Integer value stored in Local variable 
is greater or equal to Integer value passed in second parameter. 


Opcode definition: 


bool is int local variable greater or equal to value (int Local variable, 
int Value) 


Parameters: 


1) Passed: Integer, Local variable, supposed as greater or equal 
2) Passed: Integer, value to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


OAD1: show _formatted text_highpriority “INT value of local variable is 
lower than value above" 2000 
end 


' {$CLEO} 

| // Example requires CLE04 

0000: NOP 

:0029 is int_local_variable_greater_or_equal_to value 

' wait 0 

; 0@ = 6 

| if 

0029: 0@ >= 4 

then 

OAD1: show formatted text _highpriority “INT value of local variable is 
! greater or equal to value above" time 2000 // It will appear 
else 
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002A - is_int_value_greater_or_equal_to_global_variable 
Sanny Builder opcodes.txt: 002A: 0 >= $GIRL PROGRESS[4] 


Sanny Builder SASCM.INI: 002a=2, %ld% >= %2d% 
Sanny Builder short use: @ >= $GIRL_PROGRESS[4] 


Description: Math opcode. Checks if passed Integer value is greater or 
equal to Integer value stored in Global variable. 


Opcode definition: 


bool is_int_ value greater or equal _to global variable (int Value, int 
Global variable) 


Parameters: 


1) Passed: Integer, value supposed as greater or equal 
2) Passed: Integer, Global variable to compare first parameter 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:002A_is int_value_greater_or_equal_to_global_variable 
wait 0 
$89 = 64 


if 

002A: 70 >= $89 

then 

OAD1: show _formatted text_highpriority “INT value from above of is 
greater or equal to value of global variable" time 2000 // It will appear 

else 

OAD1: show _formatted text_highpriority “INT value from above is lower 
than of global variable" 2000 

end 


002B - is_int_value_greater_or_equal_to_local_variable 
Sanny Builder opcodes.txt: 002B: 3000 >= 8@ 


Sanny Builder SASCM.INI: 002B: 3000 >= 8@ 
Sanny Builder short use: 3000 >= 8@ 


Description: Math opcode. Checks if passed Integer value is greater or 
equal to Integer value stored in Local variable. 


Opcode definition: 


bool is int value greater or equal to local variable (int Value, int 
Local variable) 


Parameters: 


1) Passed: Integer, value supposed as greater or equal 
2) Passed: Integer, Global variable to compare first parameter 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:002B is int_value_greater_or_equal_to_local_variable 
wait 0 
0@ = 2000 


if 

002B: 3000 >= 0@ 

then 

OAD1: show _formatted text_highpriority “INT value from above of is 
greater or equal to value of local variable" time 2000 // It will appear 

else 

OAD1: show _formatted text_highpriority “INT value from above is lower 
than value of local variable" 2000 

end 


002C - is _int_global_variable_greater_or_equal_to_global_variable 
Sanny Builder opcodes.txt: 002C: | $SAVE PICKUPS INDEX >= 
$TOTAL AVAILABLE SAVE PICKUPS // (int) 


Sanny Builder SASCM.INI: 002c=2, ‘%ld% >= %2d% ; (int) 


Sanny Builder short use: $SAVE PICKUPS INDEX >= 
$TOTAL AVAILABLE SAVE PICKUPS 


Variable types must be declared before. 


Description: Math opcode. Checks if Integer value of the first Global 
variable is greater or equal to the Integer value stored in second Global variable. 


Opcode definition: 


bool is int global variable greater or equal to global variable (int 


Global _ variable, int Global variable) 


Parameters: 


1) Passed: Integer, Global variable supposed as greater or equal 
2) Passed: Integer, Global variable to compare first parameter 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:002C_is int_global_variable_greater_or_equal_to_global_variable 


OAD1: show _formatted text_highpriority "INT value of first global 
variable of is greater or equal to the value of second global variable" time 
2000 // It will appear 

else 

OAD1: show _formatted text_highpriority "INT value of first global 
variable is lower than the value of second global variable" 2000 


: 002C: $89 >= $90 // (int) | 
end 
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002D - is_int_local_variable_greater_or_equal_to_local_variable 
Sanny Builder opcodes.txt: 002D: 43@ >= 271@ // (int) 


Sanny Builder SASCM.INI: 002d=2, %1ld% >= %2d% ; (int) 
Sanny Builder short use: 43@ >= 271@ 
Variable types must be declared before. 


Description: Math opcode. Checks if Integer value of the first Local variable 
is greater or equal to the Integer value stored in second Local variable. 


Opcode definition: 


bool is int local variable greater or equal _to local variable (int 


Local_variable, int Local variable) 


Parameters: 


1) Passed: Integer, Local variable supposed as greater or equal 
2) Passed: Integer, local variable to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0} 
// Example requires CLE04 
0000: NOP 
:002D is int_local_variable_greater_or_equal_to_local_variable 
wait 0 
0@ = 50 // bigger or equal 
1@ = 20 // smaller 
aT 
then 


OAD1: show _formatted text_highpriority “INT value of first local 
variable of is greater or equal to the value of second local variable" time 
2000 // It will appear 

else 

OAD1: show formatted text_highpriority “INT value of first local 
variable is lower than the value of second local variable" 2000 


: 0020: 0@>=1@ // (int) 
end 
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O0O2E - is_int_global_variable_greater_or_equal_to_local_variable 
Sanny Builder opcodes.txt: 002E: $DIALOG ARRAY SIZE >= 131@ // (int) 


Sanny Builder SASCM.INI: 002e=2, ‘%ld% >= %2d% ; (int) 
Sanny Builder short use: $DIALOG ARRAY SIZE >= 131@ 
Variable types must be declared before. 


Description: Math opcode. Checks if Integer value of the first Global 
variable is greater or equal to the Integer value stored in second Local variable. 


Opcode definition: 


bool is_ int global variable greater or equal _to local variable (int 


Global _ variable, int Local variable) 


Parameters: 


1) Passed: Integer, Global variable supposed as greater or equal 
2) Passed: Integer, Local variable to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:002E is int_global_variable_greater_or_equal_to_local_variable 
wait 0 


$89 = 50 // bigger or equal 
1a = 20 // smaller 

if 

then 


OAD1: show _formatted text_highpriority "INT value of first global 
variable of is greater or equal to the value of second local variable" time 
2000 // It will appear 

else 

OAD1: show _formatted text_highpriority "INT value of first global 
variable is lower than the value of second local variable" 2000 


: Q02E: $89 >= 1@ // (int) | 
end 


tumn ANAIE te ant alnhal wariahla araatar ar anual ta Taral warisahla 


002F - is_int_local_variable_greater_or_equal_to_global_variable 
Sanny Builder opcodes.txt: 002F: 1@ >= $1264($1288,2i) // (int) 


Sanny Builder SASCM.INI: Q002F=2, %1ld% >= %2d% ; (int) 
Sanny Builder short use: 1@ >= $1264($1288,2i) 
Variable types must be declared before. 


Description: Math opcode. Checks if Integer value of the first Local variable 
is greater or equal to the Integer value stored in second Global variable. 


Opcode definition: 


bool is_int_local variable greater or equal _to global variable (int 


Local_variable, int Global variable) 


Parameters: 


1) Passed: Integer, Local variable supposed as greater or equal 
2) Passed: Integer, Global variable to compare first parameter 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:002F_is int_local_variable_greater_or_equal_to_global_variable 
wait 0 
0@ = 50 // bigger 


$89 = 20 J// smaller 
if 
then 


OAD1: show formatted text_highpriority “INT value of first local 
variable of is greater or equal to the value of second global variable" time 
2000 // It will appear 

else 

OAD1: show formatted text_highpriority “INT value of first local 
variable is lower than the value of second global variable" 2000 


: 002F: 0@ >= $89 // (int) | 
end 


tumn ANAIE te ant Taral warisahla araatar ar anual ta alnhal warishla 


0030 - is_float_global_variable_greater_or_equal_to_value 
Sanny Builder opcodes.txt: 0030: | $STAT PERCENTAGE COMPLETED >= 100.0 


Sanny Builder SASCM.INI: 0030=2, ‘%ld% >= %2d% 
Sanny Builder short use: $STAT_ PERCENTAGE COMPLETED >= 100.0 


Description: Math opcode. Checks if Float value of the first Global variable 
is greater or equal to the Float value passed in second parameter. 


Opcode definition: 


bool is float global variable greater or equal to value (float 
Global variable, float Value) 


Parameters: 


1) Passed: Float, Global variable supposed as greater or equal 
2) Passed: Float, value to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0030_ is float_global_variable_greater_or_equal_to value 
wait 0 
$89 = 120.0 


if 

0030: $89 >= 100.0 
then 

OAD1: show _formatted text_highpriority “FLOAT value of first global 

| variable of is greater or equal to the value" time 2000 // It will appear 
else 

OAD1: show _formatted text_highpriority “FLOAT value of first global 

' variable is lower than the value" 2000 

end 


iumn ANAAN ic Fflaat alnhal wariahla araatar ar anual ta vwaliua 


0031 - is_float_local_variable_greater_or_equal_to_value 
Sanny Builder opcodes.txt: 0031: 42@ >= 0.05 


Sanny Builder SASCM.INI: 0031=2, ‘%ld% >= %2d% 
Sanny Builder short use: 42@ >= 0.05 


Description: Math opcode. Checks if Float value of the first Local variable is 
greater or equal to the Float value passed in second parameter. 


Opcode definition: 


bool is float local variable greater or equal to value (float 
Local_variable, float Value) 


Parameters: 


1) Passed: Float, Local variable supposed as greater or equal 
2) Passed: Float, value to compare first parameter with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0031_is float_local_variable_greater_or_equal_to_value 
wait 0 
0@ = 120.0 


if 

0031: 0@ >= 0.05 
then 

OAD1: show _formatted text_highpriority “FLOAT value of first local 

| Variable of is greater or equal to the value" time 2000 // It will appear 
else 

OAD1: show _formatted text_highpriority “FLOAT value of first local 

' variable is lower than the value" 2000 

end 


iumn ANAA1T ic Fflaat Taral wariahla araatar ar anual ta walia 


0032 - is _float_value_greater_or_equal_to_global_variable 
Sanny Builder opcodes.txt: 0032: 8.0 >= $5925[0] 


Sanny Builder SASCM.INI: 0032=2, ‘%ld% >= %2d% 
Sanny Builder short use: 8.0 >= $5925[0] 


Description: Math opcode. Checks if specified Float value is greater or 
equal to the Float value stored in Global variable. 


Opcode definition: 


bool is float value greater or equal to global variable (float Value, 


float Global variable) 


Parameters: 


1) Passed: Float, value supposed as greater or equal 
2) Passed: Float, Global variable to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


| :0032_is_float_value_greater_or_equal_to_ global_variable 
‘wait 0 
' $tempvar Float_1 = 2.1 ! 
a 
0032: 8.0 >= $tempvar Float 1 
then 
OAD1: show_formatted_text_highpriority "specified FLOAT value is greater | 
; or equal to the value of global variable" time 2000 // It will appear 
else 
OAD1: show formatted text highpriority “specified FLOAT value is lower 
' than value of global variable” 2000 
end 


iumn AMAA? ic Fflaat walua araatar ar anual ta alnhal wariahla 


0033 - is_float_value_greater_or_equal_to_local_variable 
Sanny Builder opcodes.txt: 0033: -0.05 >= 42@ 


Sanny Builder SASCM.INI: 0033=2, ‘%ld% >= %2d% 
Sanny Builder short use: -0.05 >= 42@ 


Description: Math opcode. Checks if specified Float value is greater or 
equal to the Float value stored in Local variable. 


Opcode definition: 


bool is float value greater or equal to local variable (float Value, float 
Local variable) 


Parameters: 


1) Passed: Float, value supposed as greater or equal 
2) Passed: Float, Local variable to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


| 10033_is_float_value_greater_or_equal_to_local_variable 
i wait 0 
' 0@ = 70.3 
La 
0033: 70.6 >= 0@ 
then 
OAD1: show_formatted_text_highpriority "specified FLOAT value is greater | 
; Or equal to the value of local variable" time 2000 // It will appear 
else 
OAD1: show formatted text highpriority “specified FLOAT value is lower 
' than value of local variable" 2000 
| end 


iumn ANNAA ic Fflaat waliua araatar ar anual ta Tacal wariahla 


0034 - is _float_global_variable_greater_or_equal_to_global_variable 
Sanny Builder opcodes.txt: 0034: $8276 >= $8278 // (float) 


Sanny Builder SASCM.INI: 0034=2, ‘%ld% >= %2d% ; (float) 
Sanny Builder short use: $8276 >= $8278 
Variable types must be declared before. 


Description: Math opcode. Checks if specified Float value of the first Global 
variable is greater or equal to the Float value stored in second Global variable. 


Opcode definition: 


bool is float value greater or equal to local variable (float 


Global _ variable, float Global variable) 


Parameters: 


1) Passed: Float, Global variable supposed as greater or equal 
2) Passed: Float, Global variable variable to compare first variable 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0034 is float_global_variable_greater_or_equal_to global_variable 
wait 0 


$tempvar Float 1 = 65.0 

$tempvar Float 2 = 50.0 
Lf 
0034: $tempvar Float 1 >= $tempvar Float 2 // (float) 
then 


OAD1: show _formatted text_highpriority “specified FLOAT value of global 
variable is greater or equal to the value of second global variable" time 
2000 // It will appear 

else 

OAD1: show _formatted text_highpriority “specified FLOAT value of global 
variable is lower than the value of second global variable" 2000 

end 


0034 - is _float_global_variable_greater_or_equal_to_global_variable 
Sanny Builder opcodes.txt: 0034: $8276 >= $8278 // (float) 


Sanny Builder SASCM.INI: 0034=2, ‘%ld% >= %2d% ; (float) 
Sanny Builder short use: $8276 >= $8278 
Variable types must be declared before. 


Description: Math opcode. Checks if specified Float value of the first Global 
variable is greater or equal to the Float value stored in second Global variable. 


Opcode definition: 


bool is float global variable greater or equal to global variable 
(float Global variable, float Global variable) 


Parameters: 


1) Passed: Float, Global variable supposed as greater or equal 
2) Passed: Float, Global variable variable to compare first variable 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0034 is float_global_variable_greater_or_equal_to_global_variable 
wait 0 


$tempvar Float 1 = 65.0 
$tempvar Float 2 = 50.0 
Lf 
then 


OAD1: show _formatted text_highpriority “specified FLOAT value of global 
variable is greater or equal to the value of second global variable" time 
2000 // It will appear 

else 

OAD1: show _formatted text_highpriority “specified FLOAT value of global 
variable is lower than the value of second global variable" 2000 


0034: $tempvar Float _ 1 >= $tempvar Float 2 // (float) 
end ! 


0035 - is_float_local_variable_greater_or_equal_to_local_variable 
Sanny Builder opcodes.txt: 0035: 98@€ >= 50@ // (float) 


Sanny Builder SASCM.INI: 0035=2, ‘%ld% >= %2d% ; (float) 
Sanny Builder short use: 98@ >= 50@ 
Variable types must be declared before. 


Description: Math opcode. Checks if specified Float value of the first Local 
variable is greater or equal to the Float value stored in second Local variable. 


Opcode definition: 


bool is float local variable greater or equal to local variable (float 


Local_variable, float Local variable) 


Parameters: 


1) Passed: Float, Local variable supposed as greater or equal 
2) Passed: Float, Local variable variable to compare first variable 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0035 is float_global_variable_greater_or_equal_to global_variable 
wait 0 

0@ 
1@ 


if 

0035: 0@ >= 10 VY (float) 

then 

OAD1: show formatted text _highpriority “specified FLOAT value of local 
variable is greater or equal to the value of second global variable" time 
2000 // It will appear 

else 

OAD1: show formatted text highpriority "specified FLOAT value of local 
variable is lower than the value of second local variable" 2000 

end 


0036 - is_float_global_variable_greater_or_equal_to_local_variable 


Sanny Builder opcodes.txt: 0036: | $TEMPVAR FLOAT 1 >= 181@(217@,8f) // 
(float) 


Sanny Builder SASCM.INI: 0036=2, ‘%ld% >= %2d% ; (float) 
Sanny Builder short use: $TEMPVAR FLOAT 1 >= 50@ 
Variable types must be declared before. 


Description: Math opcode. Checks if specified Float value of the first Global 
variable is greater or equal to the Float value stored in second Local variable. 


Opcode definition: 


sea 


bool is float global variable greater or equal to local variable (float 


Global _ variable, float Local variable) 


Parameters: 


1) Passed: Float, Global variable supposed as greater or equal 
2) Passed: Float, Local variable variable to compare first variable 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0036_ is float_global_variable_greater_or_equal_to_local_variable 
wait 0 

$TEMPVAR FLOAT 1 = 60.0 

l@ = 50.0 


if 

0036: $TEMPVAR FLOAT 1 >= 1@ // (float) 

then 

; OAD1: show formatted text highpriority “specified FLOAT value of global 
; Variable is greater or equal to the value of second local variable" time 

| 2000 // It will appear 

else 

OAD1: show _formatted text_highpriority “specified FLOAT value of global 
| Variable is lower than the value of second local variable" 2000 

end 


0037 - is_float_local_variable_greater_or_equal_to_global_variable 


Sanny Builder opcodes.txt: 0037: 189@(217@,8f) >= $TEMPVAR FLOAT 2 // 
(float) 


Sanny Builder SASCM.INI: 0037=2, ‘%ld% >= %2d% ; (float) 
Sanny Builder short use: 50@>= $TEMPVAR FLOAT 1 
Variable types must be declared before. 


Description: Math opcode. Checks if specified Float value of the first Local 
variable is greater or equal to the Float value stored in second Global variable. 


Opcode definition: 


-41 


bool is float global variable greater or equal to local variable (float 


Local_variable, float Global variable) 


Parameters: 


1) Passed: Float, Local variable supposed as greater or equal 
2) Passed: Float, Global variable variable to compare first variable 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0037_is_ float_local_variable_greater_or_equal_to_global_variable 
wait 0 

$TEMPVAR FLOAT 1 = 50.0 

1@ = 60.0 


if 

0037:  1@ >= $TEMPVAR FLOAT 1 // (float) 

then 

OAD1: show formatted text _highpriority “specified FLOAT value of local 
variable is greater or equal to the value of second global variable" time 
2000 // It will appear 

else 

OAD1: show formatted text highpriority “specified FLOAT value of local 
variable is lower than the value of second global variable" 2000 

end 


00368 - is_int_global_variable_equal_to_ value 
Sanny Builder opcodes.txt: 0038: $672 == 


Sanny Builder SASCM.INI: 0038=2, %ld% == %2d% 
Sanny Builder short use: $672 == 


Description: Math opcode. Checks if the Integer value of Global variable is 
equal to the specified value. 


Opcode definition: 


bool is int global variable equal to value (int Global variable, int 


Parameters: 


1) Passed: Integer, Global variable 
2) Passed: Integer, Value to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0038 is int_global_variable_equal_to value 


OAD1: show _formatted text_highpriority “specified INT value of global 
variable is equal to the value" time 2000 // It will appear 

else 

OAD1: show _formatted text_highpriority “specified INT value of global 
variable is not equal to the value" 2000 

end 


0039 - is_int_local_variable_equal_to_value 
Sanny Builder opcodes.txt: 0039: 1@ == 


Sanny Builder SASCM.INI: 0037=2, ‘%ld% >= %2d% ; (float) 
Sanny Builder short use: 1@ == 


Description: Math opcode. Checks if the Integer value of Local variable is 
equal to the specified value. 


Opcode definition: 


bool is int local variable equal _to value (int Local variable, int 


Parameters: 


1) Passed: Integer, Local variable 
2) Passed: Integer, Value to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0039 is int_local_variable_equal_to value 
wait 0 
la = 0 


if 

0039: 1@ == 

then 

OAD1: show formatted text _highpriority “specified INT value of local 
variable is equal to the value" time 2000 // It will appear 

else 

OAD1: show formatted text highpriority “specified INT value of local 
variable is not equal to the value" 2000 

end 


003A - is_int_global_variable_equal_to_global_variable 
Sanny Builder opcodes.txt: 003A: $GIRL DATED NOW == $GIRLFRIEND // 
(int) 


Sanny Builder SASCM.INI: 003a=2, ‘%ld% == %2d% ; (int) 
Sanny Builder short use: $GIRL_DATED NOW == $GIRLFRIEND 
Variable types must be declared before. 


Description: Math opcode. Checks if the Integer value of Local variable is 
equal to the value stored in second Local variable. 


Opcode definition: 


bool is int global variable equal to global variable (int 


Global _ variable, int Global variable) 


Parameters: 


1) Passed: Integer, Global variable 
2) Passed: Integer, Global variable to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:003A_is_ int_global_variable_equal_to_global_variable 
wait 0 

$89 
$90 


OAD1: show _formatted text_highpriority “INT value of global variable is 
equal to the value stored in second global variable" time 2000 // It will 
appear 

else 

OAD1: show _formatted text_highpriority “INT value of global variable is 
not equal to the value stored in second global variable" 2000 


| @O3A:—«$89 == $90 // (int) | 
: end : 


003B - is_int_local_variable_equal_to_local_variable 
Sanny Builder opcodes.txt: 003B: 18@ == 21@ // (int) 


Sanny Builder SASCM.INI: 003b=2, %ld% == %2d% ; (int) 
Sanny Builder short use: 18@ == 21@ 
Variable types must be declared before. 


Description: Math opcode. Checks if the Integer value of Local variable is 
equal to the value stored in second Local variable. 


Opcode definition: 


bool is_int_local variable equal to local variable (int 


Local_variable, int Local variable) 


Parameters: 


1) Passed: Integer, Local variable 
2) Passed: Integer, Local variable to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:003B_is_int_local_variable_equal_to_local_variable 


OAD1: show _formatted text_highpriority "INT value of local variable is 
equal to the value stored in second local variable" time 2000 // It will 
appear 

else 

OAD1: show _formatted text_highpriority "INT value of local variable is 
not equal to the value stored in second local variable" 2000 


003B: 18@ == 21@ // (int) 
: end : 


003C - is_int_global_variable_equal_to_local_variable 
Sanny Builder opcodes.txt: 003C: | $CAR MODELS TO EXPORT(4@,10i) == 6@ 
#/ (int) 


Sanny Builder SASCM.INI: 003c=2, ‘%ld% == %2d% ; (int) 
Sanny Builder short use: $CAR_MODELS TO EXPORT(4@,10i) == 6@ 
Variable types must be declared before. 


Description: Math opcode. Checks if the Integer value of Local variable is 
equal to the value stored in second Local variable. 


Opcode definition: 


bool is int global variable equal to local variable (int 


Global _ variable, int Local variable) 


Parameters: 


1) Passed: Integer, Global variable 
2) Passed: Integer, Local variable to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


| 1003C_is int_global_variable_equal_to_local_variable 
‘wait 0 

' 6@ = 50 
, $89 = 50 

if 
003C: $89 == 6@ // (int) 
then 
OAD1: show _formatted text_highpriority “INT value of global variable is |! 
: equal to the value stored in second local variable" time 2000 // It will 
| appear 
else 
OAD1: show _formatted text_highpriority “INT value of global variable is! 
i not equal to the value stored in second local variable" 2000 

end 


0042 - is float_global_variable_equal_to_value 
Sanny Builder opcodes.txt: 0042: $279 == 0.0 


Sanny Builder SASCM.INI: 0042=2, ‘%ld% == %2d% 
Sanny Builder short use: $279 == 0.0 


Description: Math opcode. Checks if the Float value of Global variable is 
equal to the specified value. 


Opcode definition: 


bool is float global variable equal to value (float Global variable, 


float Value) 


Parameters: 


1) Passed: Float, Global variable 
2) Passed: Float, Value to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


| 10042 is float_global_variable_equal_to value 
i wait 0 
' $TEMPVAR_FLOAT_1 = 52.0 
if 
0042: $TEMPVAR FLOAT_1 == 52.0 
then 
OAD1: show formatted text highpriority "FLOAT value of global variable 
' is equal to the specified value" time 2000 // It will appear 
else 
OAD1: show formatted text_highpriority "FLOAT value of global variable 
is not equal to the specified value" 2000 
end 


iumn @A042 is float alohal variable eaual to value 


0043 - is_float_local_variable_equal_to_ value 
Sanny Builder opcodes.txt: 0043:  301@ == 0.2 


Sanny Builder SASCM.INI: 0043=2, ‘%ld% == %2d% 
Sanny Builder short use: 301@ == 0.2 


Description: Math opcode. Checks if the Float value of Local variable is 
equal to the specified value. 


Opcode definition: 


bool is float local variable equal to value (float Local variable, 


float Value) 


Parameters: 


1) Passed: Float, Local variable 
2) Passed: Float, Value to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


| 10043 is float_local_variable_equal_to value 
i wait 0 

| 0@ = 0.2 
if 
0043: 0@ == 0.2 
then 
OAD1: show formatted text highpriority "FLOAT value of local variable is ! 
' equal to the specified value" time 2000 // It will appear 
else 
OAD1: show formatted text_highpriority "FLOAT value of local variable is 
i‘ not equal to the specified value" 2000 

end 


iumn @0043 is float local variahle eaual to value 


0044 - is float_global_variable_equal_to_global_variable 


Sanny Builder opcodes.txt: 0044: $3499 == $3507($8549,151f) // 
(float) 


Sanny Builder SASCM.INI: 0044=2, ‘%ld% == %2d% ; (float) 
Sanny Builder short use: $3499 == $3507($8549,151f) 
Variable types must be declared before. 


Description: Math opcode. Checks if the Float value of the first Global 
variable is equal to the value stored in second Global variable. 


Opcode definition: 


bool is float global variable equal to global variable (float 


Global _ variable, float Global variable) 


Parameters: 


1) Passed: Float, Global variable 
2) Passed: Float, Global variable to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 


:0044 is float_global_variable_equal_to_global_variable 
wait 0 


$TEMPVAR FLOAT 1 = 4.5 
$TEMPVAR FLOAT 2 = 4.5 
if 
then 


OAD1: show formatted text _highpriority "FLOAT value of global variable 
is equal to the value stored in second global variable" time 2000 // It 
will appear 

else 

OAD1: show formatted text highpriority "FLOAT value of global variable 
is not equal to the value stored in second global variable" 2000 


0044:  $TEMPVAR FLOAT 1 == $TEMPVAR FLOAT 2 // (float) 
end 


0045 - is _float_local_variable_equal_to_local_variable 
Sanny Builder opcodes.txt: 0045: 85@ == 69@ // (float) 


Sanny Builder SASCM.INI: 0045=2, ‘%ld% == %2d% ; (float) 
Sanny Builder short use: 85@ == 69@ 
Variable types must be declared before. 


Description: Math opcode. Checks if the Float value of the first Local 
variable is equal to the value stored in second Local variable. 


Variable types must be declared before. 


Opcode definition: 


bool is float local variable equal to local variable (float 


Local_variable, float Local variable) 


Parameters: 


1) Passed: Float, Local variable 
2) Passed: Float, Local variable to compare first variable with 


Returns true or false? Yes. 


Page 165 of 186 


Example in Sanny Builder: 


{$CLEO} 
// Example requires CLE04 
0000: NOP 


:0045 is _float_local_variable_equal_to_local_variable 
wait 


Goool 


1 
| 
if 
0045: 0@==1@ Y/Y (float) 
then 
OAD1: show _formatted text_highpriority "FLOAT value of local variable is |! 
equal to the value stored in second local variable" time 2000 // It will 
appear 
else 
OAD1: show _formatted text_highpriority “FLOAT value of local variable is ! 


not equal to the value stored in second local variable" 2000 
end 


0046 - is float_global_variable_equal_to_local_variable 
Sanny Builder opcodes.txt: 0046: $var == 0@ // (float) 


Sanny Builder SASCM.INI: 0046=2, ‘%ld% == %2d% ; (float) 
Sanny Builder short use: $TEMPVAR FLOAT 1 == 0@ 
Variable types must be declared before. 


Description: Math opcode. Checks if the Float value of the first Global 
variable is equal to the value stored in second Local variable. 


Variable types must be declared before. 


Opcode definition: 


bool is float local variable equal to local variable (float 


Global _ variable, float Local variable) 


Parameters: 


1) Passed: Float, Global variable 
2) Passed: Float, Local variable to compare first variable with 


Returns true or false? Yes. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0000: NOP 
:0046 is float_global_variable_equal_to_local_variable 
wait 0 
$TEMPVAR FLOAT 1 = 0.1 
0@ = 0.1 
if 
then 


OAD1: show formatted text _highpriority "FLOAT value of global variable 
is equal to the value stored in second local variable" time 2000 // It will 
appear 

else 

OAD1: show formatted text highpriority "FLOAT value of global variable 
is not equal to the value stored in second local variable" 2000 


0046: $TEMPVAR FLOAT 1 == 0@ // (float) 
end | 


004D - jump if false 
Sanny Builder opcodes.txt: 004D: jump if false @MAIN_4068 


Sanny Builder SASCM.INI: 004D=1,jump if false %1lp% 
Sanny Builder keyword: else_jump ( else_jump @label ) 
jf ( jf @label ) 


Description: Jumps the code to the specified offset called label if "false" is 
the current state of the thread. Label is negative number, offset relative to 
beginning of SCM file. 


Opcode definition: 


void jump if false (int Offset) 


Parameters: 


1) Passed: integer, label - negative offset in script file. (OFFSET * - 


Returns true or false? No. 
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Example in Sanny Builder: 


{$CLE0O} 
// Example requires CLE04 
0@ = 3 


| :004D jump_if_false 
i wait 0 

| if | 
| 0@ == ; 
' Q04D: jump if false @not_3 
| OAD1: show _formatted text_highpriority "variable contains 3 value" time 2000 
jump @004D_ jump_if_false 


:not_3 
OAD1: show _formatted text_highpriority "variable does not contain 3 value" 


time 2000 
iumn @AAAD iumn if false 


OO4E - TERMINATE_THIS_SCRIPT 
Sanny Builder opcodes.txt: 004E: end_thread 


Sanny Builder SASCM.INI: 004e=0,end thread 


Sanny Builder keyword: end_thread 

Native name: TERMINATE THIS SCRIPT 

Description: Terminates current thread, thus current thread is no longer 
executed . 


Opcode definition: 


void terminate this script () 


Parameters: 


No parameters 


Returns true or false? No. 
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Example in Sanny Builder: 


// It is not stripped SCM to reuse 
// Many things are missing here 
// It is just example 


// Instruction: 

// Compile this main. txt as main.scm 

// Run a new game 

// In game GXT text will be shown 

// Press entering key, entter or F to terminate this thread 
// GXT text will disappear 


DEFINE MISSIONS 0 

//DEFINE MISSION {ID} 0 AT {LABEL} @ 

DEFINE EXTERNAL SCRIPTS 0 // Use -1 in order not to compile AAA script 
//DEFINE SCRIPT {NAME} AT {LABEL} @ 

DEFINE UNKNOWN EMPTY SEGMENT 0 

DEFINE UNKNOWN THREADS MEMORY 0 


1 0053: $PLAYER CHAR = create player #NULL at 2488.56 -1666.84 13.38 
! 01F5: $PLAYER ACTOR = create player_actor $PLAYER CHAR 

' Q7AF: $PLAYER_GROUP = player $PLAYER_CHAR group 

' Q70D: rebuild player $PLAYER CHAR 

| 016A: fade 1 time 0 


0180: set_on mission flag to $ONMISSION 


// put your create thread commands here 

CREATE_THREAD @004E_end_thread // Thread will be be executed since now 
(after first wait from this thread) 

// More threads will be active 


:MAIN_LOOP 
wait 0 
jump @MAIN_LOOP 


:004E_end_thread 

wait 0 

if 

OOE1: player 0 pressed key 15 // Press Enter / Exit and this thread 
will be terminated 

else_jump @Show_GXT_text 


004E: end_thread // This thread is terminated and is not executed 
anymore. GXT text will disapear 


: Show_GXT_text 
AARC: shaw text hiahnrioritv GXT 'TF232' time 1000 Fflaadq 1 


aa cen a a ee Rn ia Pt Sy ace Pa ar catty EAN ah han eee a kg a aa se le fa et sm 


004F - START_NEW_SCRIPT_WITH_ARGS 
Sanny Builder opcodes.txt: 004F: create_thread @MS BIKE_MISSIONS 
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Sanny Builder SASCM.INI: 004f=-1,create thread 
Sanny Builder keyword: create_thread ( create_thread @thread_label ) 


Description: Starts new thread pointing to a specified label . Should be 
used in main.scm, not in CLEO scripts. Created thread will be need own wait 
opcodes and jumps, because it works separately. 


Native name: START NEW SCRIPT WITH ARGS 


Opcode definition: 


void start_new_script (int Offset) 


Parameters: 


1) Passed: integer, label - negative offset in script file. (OFFSET * - 


Returns true or false? No. 
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Example in Sanny Builder: 


// It is not stripped SCM to reuse 
// Many things are missing here 
// It is just example 


// Instruction: 
// Compile this main.txt as main.scm 
// Start a new game 
// In game GXT text will be shown constantly 


DEFINE MISSIONS 0 
//DEFINE MISSION {ID} 0 AT {LABEL} @ 

DEFINE EXTERNAL SCRIPTS 0 // Use -1 in order not to compile AAA script 
//DEFINE SCRIPT {NAME} AT {LABEL} @ 

DEFINE UNKNOWN EMPTY SEGMENT 0 

DEFINE UNKNOWN THREADS MEMORY 0 


0053: $PLAYER_ CHAR = create player #NULL at 2488.56 -1666.84 13.38 
; O1F5: $PLAYER ACTOR = create player_actor $PLAYER CHAR 
O7AF: $PLAYER GROUP = player $PLAYER CHAR group 


070D: rebuild player $PLAYER CHAR 
016A: fade 1 time 0 
0180: set_on mission flag to $ONMISSION 


// put your create thread commands here 

004F: create_thread @Show_GXT_text_show // Thread will be be executed 
since now (after first wait from this thread) 

// More threads will be active 


:MAIN_LOOP 

wait 0 

jump @MAIN_LOOP 

: Show_GXT_text_show 
wait 0 

OOBC: show text _highpriority GXT 'IE23' time 1000 flag 1 


0050 - gosub 
Sanny Builder opcodes.txt: 0050: gosub @SUB_FADE_500MS 


Sanny Builder SASCM.INI: 0050=1,gosub %1p% 
Sanny Builder keyword: gosub ( gosub @label ) 


Description: Executes the code in the specified label until the label returns. 
Then the code carries on. 


Opcode definition: 


void gosub (int Offset) 
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Parameters: 


1) Passed: integer, label - negative offset in script file. (OFFSET * - 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


t 
Instruction: 
- Compile CLEO script 
- Run the game 
- Press Enter/F to execute gosub 
- Player will be locked or unlocked 


} 
:0050 gosub_lock 
wait 0 
af 
OOE1: player 0 pressed key 15 // Press Enter/F 
else_jump @0050_ gosub_ lock 
0050: gosub @PLAYER_LOCK 
wait 400 
:0050 gosub_unlock 
wait 0 
if 
OOE1: player 0 pressed key 15 // Press Enter/F 
else_jump @0050_ gosub_unlock 


0050: gosub @PLAYER_RESTORE_CONTROL 


0051 - return 
Sanny Builder opcodes.txt: 0051: return 


Sanny Builder SASCM.INI: 0051=0, return 
Sanny Builder keyword: return 
Description: Returns the code back to where the gosub opcode was used. 


Opcode definition: 


void gosub () 
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Parameters: 


No parameters 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 


t 
Instruction: 
- Compile CLEO script 
- Run the game 
- Press Enter/F to execute gosub 
- Player will be locked or unlocked 


} 

:0050 gosub_lock 

wait 0 

if 

OOE1: player 0 pressed key 15 // Press Enter/F 
else_jump @0050_gosub_ lock 


gosub @PLAYER_LOCK 


wait 400 


wait 0 

if 

OOE1: player 0 pressed key 15 // Press Enter/F 
else_jump @0050_ gosub_unlock 


gosub @PLAYER_RESTORE_CONTROL 


wait 400 
jump @0050_gosub_lock 


: PLAYER_LOCK 
Actor.LockInCurrentPosition($PLAYER ACTOR) = True 
Actor.SetImmunities($PLAYER ACTOR, 1, 1, 1, 1, 1) 
Player.CanMove($PLAYER CHAR) = False 

0051: return // described opcode here 


:PLAYER_RESTORE_CONTROL 
Player.CanMove($PLAYER CHAR) = True 
Actor.SetImmunities($PLAYER ACTOR, 0, 0, 0, 0, 0) 
Actor.LockInCurrentPosition($PLAYER ACTOR) = False 


:0050 gosub_unlock | 


Page 173 of 186 


0052 - NOP_floats 
Sanny Builder opcodes.txt: 0052: NOP 98@ 100@ $TEMPVAR FLOAT 3 99@ 100@ 
$TEMPVAR_ FLOAT 3 


Sanny Builder SASCM.INI: 0052=6,NOP %ld% %2d% %3d% %4d% %5d% %6d% 


Description: Does nothing. This opcode probably showed values of 
arguments on screen at development stage. 


Opcode definition: 


void NOP floats (float Argument 1, float Argument 2, float Argument 3, 


float Argument 4, float Argument_5, float Argument 6) 
Parameters: 
Passed: float, argument 


Passed: float, argument 
Passed: float, argument 


Passed: float, argument 
Passed: float, argument 
Passed: float, argument 


Returns true or false? No. 


0053 - CREATE_PLAYER 
Sanny Builder opcodes.txt: 0053: $PLAYER CHAR = create player #NULL at 
2488.562 -1666.865 12.8757 


Sanny Builder SASCM.INI: 0053=5,%5d% = create player %1lo% at %2d% 
%3d% %4d% 


Sanny Builder class method: Player.Create 
Native name: CREATE PLAYER 


Description: Creates player at the specified coordinates. The model works 
differently to other creation opcodes: 


#NULL - Player 1 
#CSPLAY - Player 2 
Player 1 wears the default CJ skin with the default clothes. 


Player 2 will have exactly the same model and clothes as the current set for 
Player 1. Creating Player 2 will create another HUD showing health, armour etc. 
of the second player. 


To change the clothes of any player, use opcode 087B. The players model can be 
changed using 097C. 
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Creating a second player with the model #NULL creates a duplicate of the player 
which can never be destroyed (using O6DF results in a crash). 


Opcode definition: 


void create player (int Model ID, float X coord, float Y coord, float 


Z_ coord, &int Player handle) 


Parameters: 


integer, Model/Ped ID 
float, X coordinate 
float, Y coordinate 


float, Z coordinate 
integer, Actor handle 


Returns true or false? No. 


Example in Sanny Builder: 


// It is not stripped SCM to reuse 
// Many things are missing here 
// It is just example 


// Instruction: 
// Compile this main.txt as main.scm 
// Start a new game 


DEFINE MISSIONS 0 

//DEFINE MISSION {ID} 0 AT {LABEL} @ 

DEFINE EXTERNAL SCRIPTS 0 // Use -1 in order not to compile AAA script 
//DEFINE SCRIPT {NAME} AT {LABEL} @ 

DEFINE UNKNOWN EMPTY SEGMENT 0 

DEFINE UNKNOWN THREADS MEMORY 0 


0053: $PLAYER CHAR = create player #NULL at 2488.56 -1666.84 13.38 Lie 
described opcode here 

// Player must be created before a first instance of wait opcode 

070D: rebuild player $PLAYER CHAR 


01F5: $PLAYER ACTOR 
O7AF: $PLAYER GROUP 
016A: fade 1 time 0 


create player actor $PLAYER CHAR 
player $PLAYER CHAR group 


a ee eee 


0058 - add_int_global_variable_to_global_variable 
Sanny Builder opcodes.txt: 0058: $1924 += $1929 // (int) 


Sanny Builder SASCM.INI: 0058=2 ,%1d% += %2d% ; (int) 
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Sanny Builder short use: $1924 += $1929 
Variable types must be declared before. 


Description: Math opcode. Adds the integer value of the second Global 
Variable to the integer value of the first Global Variable. 


Opcode definition: 


void add int global variable to global variable (int &Global variable, 


int Global variable) 


Parameters: 


1) Stored: integer, global variable 
2) Passed: integer, global variable to add 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 
$89 = 40 
$90 = 50 ! 
0058: $89 += $90 // (int) 


:0058 add_global_variable_to_global_variable 

01E4: show text 1Inumber lowpriority GXT 'NUMBER' number $89 time 2000 flag 1 
wait 1000 

jump @0058 add qlobal variable to qlobal variable 


0059 - add_float_global_variable_to_global_variable 
Sanny Builder opcodes.txt: 0059: $1316 += $1317 // (float) 


Sanny Builder SASCM.INI: 0059=2 ,%1d% += %2d% ; (float) 
Sanny Builder short use: $1316 += $1317 
Variable types must be declared before. 


Description: Math opcode. Adds the float value of the second Global 
Variable to the float value of the first Global Variable. 


Opcode definition: 


void add float global variable to global variable (float 


&Global_ variable, float Global variable) 
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Parameters: 


1) Stored: float, global variable 
2) Passed: float, global variable to add 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLEO} 
0000: NOP 
$TEMPVAR FLOAT 1 


1.5 
$TEMPVAR FLOAT 2 = 0.5 


| 0059: $TEMPVAR FLOAT 1 += $TEMPVAR FLOAT 2 // (float) ! 
// Result: 2.0 


:0059 add_float_global_variable_to_global_variable 

OAD1: show formatted text_highpriority "float value of global variable: %.3f" 
time 2000 $TEMPVAR FLOAT 1 

wait 0 

jump @0059_ add_float_global_variable_to_global_variable 


005A - add_int_local_variable_to_local_variable 
Sanny Builder opcodes.txt: 005A: 3@ += 1@ // (int) 


Sanny Builder SASCM.INI: 005a=2,%1d% += %2d% ; (int) 
Sanny Builder short use: 3@ += 1@ 
Variable types must be declared before. 


Description: Math opcode. Adds the integer value of the second Local 
Variable to the integer value of the first Local Variable. 


Opcode definition: 


void add int local variable to local variable (int &Local variable, int 


Local variable) 


Parameters: 


1) Stored: integer, local variable 
2) Passed: integer, local variable to add 


Returns true or false? No. 
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Example in Sanny Builder: 


' {$CLEO} ! 
' Q000: NOP 
1 0O@ = 4 
1 1@ = 2 
' QO5A: 0@ += 1@ // (int) 
yf Results G 
1 :005A_add_int_local_variable_to_local_variable 
01E4: show _text_1Inumber_lowpriority GXT ‘NUMBER’ number 0@ time 2000 flag 1 
' wait 1000 
! jump @005A_add_int_local_variable_to_local_variable 


CLEO3 opcodes 


OASC - write_memory 
Sanny Builder opcodes.txt: QABO: key pressed 0x73 


Sanny Builder SASCM.INI: OABO=1, key pressed %1d% 
Description: Writes a value to the game memory. 


Opcode definition: 


boolean virtual key pressed (int Memory address, int Size, int Value, 
boolean Virtual protect) 


Parameters: 


1) Passed: Integer, Memory adress 
2) Passed: Integer, Number of bytes from value to write: 1, 2 or 4- 


bytes 
3) Passed: Integer, Value to write 


Returns true or false? No. 
Example in Sanny Builder: 


1 {$CLEO} 

1 // Draws scanlines on screen 

// Works for GTA San Andreas v1.0 [US] HOODLUM No-CD Fixed EXE 
' OA8C: write memory O0xOC7C70C size 1 value 1 virtual_protect 0 

| Q@A8C: write memory Ox0C7C70D size 1 value 1 virtual protect 0 


OABO - virtual_key_pressed 
Sanny Builder opcodes.txt: QABO: key pressed 0x73 


Sanny Builder SASCM.INI: OABO=1, key pressed %1d% 


Sanny Builder class method: Key.VirtualKeyCode 
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Description: This opcode tests if the key is pressed on keyboard. If the key 
with specified code is pressed, it returns True, otherwise False. 


See table of 
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A game sequence of working. 
Opcode definition: 


boolean virtual key pressed (int nVirtKey) 


Parameters: 


1) Passed: Integer, Virtual key code 


Returns true or false? No. 


Example in Sanny Builder: 


{$CLE0} 
0000: NOP 
// Press 0 key and player will die 


| :Q@ABO_virtual_key_pressed 
‘wait 0 
' if ! 
| QABO: key pressed 48 
: else _jump @Q0ABO_virtual_key_pressed 
i OSBE: AS_actor $PLAYER ACTOR die 
‘wait 250 ms // After 250 ms key will not be pressed if user doesnt hold 

| key. 
| jump @OABO virtual key pressed 
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Terminology 
Obj - object 


Opcode native name - original names of opcodes used by Rockstar Games to 
write their scripts, retrieved from GTA IV which uses “native functions”. 


SB - Sanny Builder, program created by Seemann designed for the GTA 3D game 
series (GTA3, VC, SA; partially LCS and VCS). 


It includes a decompiler, permitting the end-user to quickly decompile the 
MAIN.SCM file which contains game scripts. The compiler feature offers a 
convenient editor with a large number of useful functions such as; syntax 
highlighting, error checking, advanced search tools, player coordinates reading, 
fast movement through code and much more. 


SCM - extension of most important file in scripting - main.scm, this file contains 
missions and scripts. 


VTOL - acronym for vertical take-off and landing aircraft. This classification 
includes fixed-wing aircraft that can hover, take off and land vertically as well as 
helicopters and other aircraft with powered rotors, such as tiltrotors. The 
terminology for spacecraft and rockets is VTVL (vertical takeoff with vertical 
landing). Some VTOL aircraft can operate in other modes as well, such as CTOL 
(conventional take-off and landing), STOL (short take-off and landing), and/or 
STOVL (short take-off and vertical landing). Others, such as some helicopters, can 
only operate by VTOL, due to the aircraft lacking landing gear that can handle 
horizontal motion. VTOL is a subset of V/STOL (vertical and/or short take-off and 
landing). Hydra in GTA SA is VTOL aircraft. 
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